
TypeScript 7 em projetos reais: o tsc ficou de 3 a 6 vezes mais rápido, e o resto da cadeia ainda roda no 6
O Dependabot abriu um pull request no exemplo React do rx-state-bridge que levava o TypeScript do 5.6 direto para o 7.0.2, e o build parou numa linha que estava ali desde o primeiro dia:
src/main.tsx(4,8): error TS2882: Cannot find module or type declarations for side-effect import of './styles.css'.
Eu corrigi com o arquivo que os templates do Vite já trazem, um vite-env.d.ts com /// <reference types="vite/client" />, e escrevi no commit que o TypeScript 7 rejeitava o import. A correção estava certa. A explicação, não: o 7 não inventou essa regra. Rodei o mesmo exemplo, sem o vite-env.d.ts, nas três versões:
TS 5.9.3 exit 0
TS 6.0.3 TS2882 em './styles.css'
TS 7.0.2 TS2882 em './styles.css'
TS 5.9.3 --noUncheckedSideEffectImports TS2307 em './styles.css'
TS 6.0.3 --noUncheckedSideEffectImports false exit 0
TS 7.0.2 --noUncheckedSideEffectImports false exit 0
O erro vem do 6.0, que passou a ligar noUncheckedSideEffectImports por padrão. O PR pulou o 6, e o 7 herdou o padrão novo. Essa é a frase que mais importa numa migração para o 7, e o anúncio oficial diz com todas as letras: o 7.0 adota os padrões do 6.0 e transforma em erro tudo o que o 6.0 tinha depreciado.
Com isso na cabeça, peguei cinco repositórios públicos meus, cada um no último commit da main até 23/10/2026, e passei cada um pelo 5.9, pelo 6.0 e pelo 7.0: o typecheck, o tempo, e cada ferramenta que eles usam além do tsc.
O que o 7.0 entrega e o que ele deixou para o 7.1
O 7.0.2 é a versão latest do pacote typescript desde 08/07/2026. É o compilador reescrito em Go, com binário nativo por plataforma (no Windows, um tsc.exe que o pacote baixa como dependência opcional) e checagem de tipos em paralelo. O anúncio fala em ganhos típicos de 8 a 12 vezes em builds completos.
O que ele não traz é a API JavaScript. O anúncio é direto: o 7.0 "does not ship with an API", e a nova API vem no 7.1. No pacote, isso aparece de um jeito bem concreto:
$ node -p "require('typescript')"
{ version: '7.0.2', versionMajorMinor: '7.0' }
No 6.0.3, o mesmo require devolve um objeto com 2.248 chaves: createProgram, DiagnosticCategory, o compilador inteiro. No 7.0.2, devolve a versão e nada mais. O package.json do 7.0.2 expõe uma API em typescript/unstable/sync, typescript/unstable/async e vizinhos, mas com unstable no nome, e nenhuma das ferramentas que testei usa esses caminhos. O 7.1.0-beta, de 20/10, traz a API com nome definitivo (typescript/sync, typescript/async, typescript/ast...) e um ponto de extensão para Vue, Svelte, MDX e afins.
Toda ferramenta que faz require('typescript') para chamar o compilador quebra com o 7.0. Para elas, a Microsoft publicou o pacote @typescript/typescript6, que reexporta a API do 6.0 e instala um binário chamado tsc6, para que os dois convivam. Volto a ele na parte da cadeia de ferramentas.
Os cinco projetos
| Projeto | O que é | TypeScript no commit de 23/10 | Arquivos no programa (TS 7) | Linhas (TS 7) |
|---|---|---|---|---|
| rx-state-bridge | biblioteca RxJS (npm) | 5.9.3 | 279 | 75.090 |
| vertex-api | API do blog, NestJS 11 | 5.9.3 | 2.774 | 334.152 |
| vertex-web | este blog, Next.js 16.3 | 5.9.3 | 1.704 | 375.155 |
| pyxis-api | API do Pyxis, NestJS 12 | 6.0.3 | 4.109 | 527.120 |
| pyxis-web | painel do Pyxis, Next.js 16.4 | 6.0.3 | 2.278 | 500.690 |
As linhas incluem as declarações de node_modules e das libs do TypeScript, que são a maior parte do programa em qualquer projeto. Nenhum desses é grande: o maior, o pyxis-web, tem cerca de 110 mil linhas de TypeScript próprio. O anúncio oficial mede o 7 no código do VS Code, do Sentry e do Playwright; aqui é o tamanho de projeto que a maioria de nós mantém.
Dois repositórios já estavam no 6.0: os do Pyxis, que nasceram em outubro já com o 6.0.3. Os outros três estavam no 5.9. Essa diferença decidiu quase tudo o que veio depois.
Quanto o tsc ganhou
Check completo (--incremental false), em segundos: mediana de 7 execuções, com mínimo e máximo.
| Projeto | 5.9.3 | 6.0.3 | 7.0.2 | 6.0 → 7.0 |
|---|---|---|---|---|
| rx-state-bridge | 0,59 (0,58–0,60) | 0,60 (0,59–0,61) | 0,13 (0,12–0,14) | 4,7x |
| vertex-api | 2,68 (2,65–2,71) | 2,73 (2,70–2,78) | 0,83 (0,82–0,85) | 3,3x |
| vertex-web | 2,81 (2,74–3,86) | 2,81 (2,75–3,68) | 0,45 (0,43–0,49) | 6,2x |
| pyxis-api | 5,94 (5,87–6,07) | 1,12 (1,07–1,16) | 5,3x | |
| pyxis-web | 8,72 (8,61–8,77) | 1,38 (1,35–1,42) | 6,3x |
Incremental, sem nenhum arquivo alterado desde a execução anterior:
| Projeto | 5.9.3 | 6.0.3 | 7.0.2 | 6.0 → 7.0 |
|---|---|---|---|---|
| rx-state-bridge | 0,42 (0,41–0,43) | 0,41 (0,40–0,42) | 0,11 (0,11–0,11) | 3,8x |
| vertex-api | 1,65 (1,62–1,67) | 1,63 (1,60–1,65) | 0,38 (0,37–0,39) | 4,3x |
| vertex-web | 1,44 (1,41–1,47) | 1,46 (1,43–1,49) | 0,32 (0,32–0,33) | 4,5x |
| pyxis-api | 2,48 (2,44–2,50) | 0,57 (0,55–0,62) | 4,3x | |
| pyxis-web | 2,06 (2,02–2,17) | 0,43 (0,41–0,44) | 4,8x |
Medi com tsc -p tsconfig.json --noEmit, cada versão rodando o mesmo projeto, intercaladas execução a execução: 7 execuções por caso, mais uma descartada para aquecer o cache de disco do sistema. "Completo" é com --incremental false, o programa inteiro checado do zero. "Incremental" é com o .tsbuildinfo de uma execução anterior e nenhum arquivo alterado, que é o que acontece quando alguém roda tsc duas vezes seguidas num projeto com incremental: true (os quatro aplicativos têm). A máquina é um Intel Core i9-13900H (14 núcleos, 20 threads), 32 GB, Windows 11, Node 24.19.0.
No check completo, o 7 ficou entre 3,3 e 6,3 vezes mais rápido que o 6. É bem menos que os 8 a 12 vezes do anúncio, e o --extendedDiagnostics ajuda a ver por quê. No pyxis-web, o 6.0.3 passa 6,71 s dos 9,06 s checando tipos; é o projeto em que a checagem domina, e é onde o 7 ganhou mais. No vertex-api, o programa tem 2.774 arquivos, quase todos declarações de node_modules, e o 7.0.2 gasta 0,35 s checando, de 0,75 s no total; o resto é ler e analisar esses arquivos. A minha leitura: quanto mais o tempo do projeto está na checagem, mais perto dos números do anúncio ele chega. Projetos pequenos ou feitos de declarações de terceiros ficam na faixa dos 3 a 5 vezes.
Do 5.9 para o 6.0, nada muda em tempo: é o mesmo compilador em JavaScript com padrões novos. O ganho inteiro está no salto para o 7.
O caso incremental é o que mais aparece no dia a dia, e nele o 7 ficou de 3,8 a 4,8 vezes mais rápido. Em números absolutos, rodar tsc de novo sem ter mudado nada custava de 1,5 a 2,5 s nos quatro aplicativos com o 6.0, e passou a custar de 0,3 a 0,6 s.
Memória, pelo Memory used do --extendedDiagnostics: no pyxis-web, 912 MiB no 6.0.3 e 826 MiB no 7.0.2; no vertex-web, 447 e 293 MiB; nos outros, a mesma direção. O número do 6 é o heap do V8 e o do 7 é o do runtime do Go, então a comparação é aproximada; não medi o pico do processo.
Os controles de paralelismo
O 7 checa tipos com quatro workers por padrão. A flag --checkers muda esse número, e --singleThreaded desliga o paralelismo de tudo, inclusive parsing e emissão. No pyxis-web, o maior dos cinco, em segundos (mediana de 7, mínimo e máximo):
| Configuração | Tempo |
|---|---|
--checkers 1 | 2,05 (2,00–2,16) |
--checkers 4 (padrão) | 1,37 (1,30–1,41) |
--checkers 8 | 1,33 (1,30–1,38) |
--singleThreaded | 2,59 (2,50–2,70) |
Passar de 4 para 8 checkers quase não mudou nada num programa desse tamanho, numa máquina de 20 threads. Mesmo com um checker só, o 7 ficou 4,3 vezes mais rápido que o 6.0.3 (2,05 s contra 8,72 s), porque parsing e emissão continuam em paralelo; com --singleThreaded, que desliga tudo, ainda ficou 3,4 vezes mais rápido. Para um runner de CI com dois ou quatro núcleos, isso diz que o ganho não depende de ter muitos núcleos. Não medi num runner de verdade.
No Windows, o tsc do pacote é um script Node que inicia o tsc.exe com execFileSync. Chamar o tsc.exe direto, sem o Node no meio, deu mediana de 1,33 s contra 1,37 s pelo tsc normal. Uns 40 ms, que não justificam mudar os scripts.
Os erros que o 7 apontou, e de onde eles vinham
Nos dois projetos do Pyxis, que já estavam no 6.0.3, o 7.0.2 não apontou nenhum erro novo. Na biblioteca e no vertex-web, também nenhum. O vertex-api, que saía do 5.9.3, foi de zero para 1.280 erros:
802 TS2304 Cannot find name 'expect' / 'jest' / 'beforeAll' / ...
412 TS2593 Cannot find name 'it' / 'describe' / 'beforeEach'
49 TS2503 Cannot find namespace 'jest'
12 TS7006 Parameter '...' implicitly has an 'any' type (em arquivos .spec.ts)
2 TS2564 Property '...' has no initializer
1 TS2345 Argument of type '...' is not assignable
2 TS7022 '...' implicitly has type 'any' because it [...] is referenced [...] in its own initializer
O 6.0.3, no mesmo código, aponta 1.278. A diferença são exatamente os dois TS7022, que ficam para a próxima seção. O resto é o 6.0.
types agora começa vazio
Até o 5.9, o TypeScript carregava sozinho todo pacote em node_modules/@types. Desde o 6.0, types tem padrão []. Os testes do vertex-api usam os globais do Jest (describe, it, expect), que vêm de @types/jest sem nenhum import, e 1.275 dos 1.280 erros eram isso: os três primeiros códigos da lista e os 12 TS7006, que são parâmetros de callbacks do Jest que ficaram sem tipo.
O @types/node não fez falta, e o motivo é instrutivo: o código importa node:crypto, node:fs e afins, e as dependências do Nest referenciam os tipos do Node. O pacote entrou no programa pelos imports. Um global que ninguém importa, como os do Jest, não tem esse caminho.
strict agora é true por padrão
Os três erros seguintes (TS2564 e TS2345) vêm de strict, que também virou padrão no 6.0. O tsconfig do vertex-api liga as flags estritas uma por uma (strictNullChecks, noImplicitAny, strictBindCallApply) e nunca declarou strict. Com o padrão novo, strictPropertyInitialization e strictFunctionTypes entraram junto. Para a migração, escrevi "strict": false, que mantém exatamente o comportamento do 5.9. Ligar o modo estrito completo é uma decisão separada, com o seu próprio PR.
rootDir agora é a pasta do tsconfig
Esse não deu erro no tsc. Deu no Jest. Com o tsconfig original e a API do 6.0, todos os 30 arquivos de teste falharam antes de rodar:
error TS5011: The common source directory of 'tsconfig.json' is './src/auth/guards'.
The 'rootDir' setting must be explicitly set to this or another path to adjust your output's file layout.
Visit https://aka.ms/ts6 for migration information.
O ts-jest compila cada arquivo de teste com o tsconfig do projeto, que tem outDir. Até o 5.9, o rootDir era inferido a partir dos arquivos. No 6.0, ele é a pasta do tsconfig, e o compilador exige que seja declarado quando os arquivos de entrada não batem com essa pasta. No build do Nest, o layout de saída não mudou: o tsconfig.build.json já incluía o drizzle.config.ts da raiz, então a saída já era dist/src/main.js no 5.9 e continuou igual no 6 e no 7 (conferi a lista de arquivos emitidos nas três versões). Declarar "rootDir": "./" resolveu o Jest sem mexer no build.
A migração do tsconfig inteira coube em três linhas:
"outDir": "./dist",
+ "rootDir": "./",
+ "types": ["node", "jest"],
+ "strict": false,
"incremental": true,
Com elas, o 6.0.3 passa sem erro. O 7.0.2 ainda aponta dois.
Os dois erros que só o 7.0.2 aponta
Os dois TS7022 apareceram numa função que pagina o Parameter Store da AWS num do/while. O 6.0.3 não reclama, nem com --stableTypeOrdering, a flag que faz o 6 ordenar tipos como o 7. O 7.0.2 reclama com qualquer número de checkers, inclusive com --singleThreaded. Então não é a ordem de checagem.
Reduzi até chegar num arquivo sem dependência nenhuma:
interface Item { name: string }
declare function send<T>(path: string): T;
declare const env: Record<string, string | undefined>;
export function load(prefix: string | undefined, more: boolean): void {
if (!prefix) return;
while (more) {
const item = send<Item>(prefix);
const name = item.name;
if (env[name] !== undefined) continue;
}
}
$ tsc --ignoreConfig --noEmit --strict g7.ts # 6.0.3
(sem saída, exit 0)
$ tsc --ignoreConfig --noEmit --strict g7.ts # 7.0.2
g7.ts(8,11): error TS7022: 'item' implicitly has type 'any' because it does not have a type annotation and is referenced directly or indirectly in its own initializer.
$ tsc --ignoreConfig --noEmit --strict g7.ts # 7.1.0-beta
(sem saída, exit 0)
Não existe circularidade nenhuma ali. Os ingredientes são um parâmetro de tipo união estreitado antes do loop (prefix), uma chamada genérica que usa esse parâmetro dentro do loop e um acesso por índice comparado dentro do mesmo loop. A mesma família aparece na issue #4673 do typescript-go, aberta em 19/07: a causa era uma função portada do compilador antigo (isMatchingConstructorReference) que ficou mais abrangente do que o original. A correção entrou em 21/07, depois do 7.0.2, e chegou ao 7.1.0-beta, que compila o arquivo acima sem erro.
Até o 7.1 estável, a saída é anotar o tipo. No vertex-api, uma linha:
const page: GetParametersByPathCommandOutput = await client.send(
new GetParametersByPathCommand({ /* ... */ }),
);
Um erro que só a versão nova aponta, num código que não mudou, merece uma redução antes de virar alteração de código. Aqui a anotação era inofensiva; reduzir foi o que mostrou que o problema estava no compilador.
O que o 7 transforma em erro
Para quem ainda está no 5.x, a lista do anúncio do 7.0 é o checklist. Padrões que mudaram no 6.0 e valem no 7.0: strict: true, module: esnext, target na versão estável mais recente do ECMAScript, noUncheckedSideEffectImports: true, libReplacement: false, stableTypeOrdering: true (sem como desligar), rootDir na pasta do tsconfig e types: []. E o que era depreciado no 6.0 e no 7.0 é erro, sem ignoreDeprecations para salvar:
target: es5edownlevelIteration;moduleResolution: node(ounode10) emoduleResolution: classic;module: amd,umd,systemjsenone;baseUrl(ospathspassam a ser relativos ao tsconfig);esModuleInterop: false,allowSyntheticDefaultImports: falseealwaysStrict: false;moduleno lugar denamespacepara declarar namespaces;assertsem imports (éwith);/// <reference no-default-lib />sobskipDefaultLibCheck;- arquivos na linha de comando quando existe um
tsconfig.jsonna pasta, a menos que se passe--ignoreConfig(por isso o--ignoreConfignos comandos acima).
O caminho que o próprio time do TypeScript recomenda é passar pelo 6.0 antes. Os meus números concordam: nos dois projetos que já estavam no 6, o 7 não pediu nada.
A cadeia de ferramentas
O tsc é a parte fácil. Instalei o typescript@7.0.2 no lugar do anterior em cada repositório e rodei o que o package.json de cada um roda no CI:
| Ferramenta | Com typescript@7.0.2 | Com o alias do 6 + @typescript/native |
|---|---|---|
tsc (typecheck, build do pyxis-api) | funciona | funciona (é o 7) |
ng build (Angular 22.2) | npm install recusa; forçado, quebra | funciona, no 6.0.3 |
next build (Next.js 16.3.8 e 16.4.2) | funciona, checa com o tsc 7 | funciona, checa com o tsc6 |
| typescript-eslint 8.x | quebra | funciona |
| ts-jest 29.4 | quebra | funciona |
nest build (Nest CLI 11) | quebra | funciona |
tsup 8.5.1 (geração de .d.ts) | quebra | quebra; o 9.0.0 funciona |
| Vitest | funciona | funciona |
"O alias" é a receita oficial do anúncio:
npm install -D "typescript@npm:@typescript/typescript6@^6.0.2" "@typescript/native@npm:typescript@^7.0.2"
Com ela, typescript aponta para o pacote de compatibilidade, e toda ferramenta que faz require('typescript') recebe a API do 6. O 7 fica em @typescript/native, e o npx tsc passa a ser o dele. O resultado, num dos repositórios:
$ npx tsc -v
Version 7.0.2
$ npx tsc6 -v
Version 6.0.3
$ node -p "require('typescript').version"
6.0.3
O @typescript/typescript6 está na versão 6.0.2, mas ele é um invólucro: depende de typescript@^6 e instalou o 6.0.3. O tsserver que aparece em node_modules/.bin também é o do 6.0.3.
Angular: o 7 fica fora do ng build
O @angular/compiler-cli 22.2.3 e o @angular/build 22.2.4 declaram typescript como peer em >=6.0 <6.1. O npm leva isso a sério:
npm error ERESOLVE unable to resolve dependency tree
npm error Found: typescript@7.0.2
npm error Could not resolve dependency:
npm error peer typescript@">=6.0 <6.1" from @angular/build@22.2.4
Com --legacy-peer-deps, o pacote instala e o ng build quebra assim que tenta ler o tsconfig:
✘ [ERROR] Angular compilation initialization failed. [plugin angular-compiler]
TypeError: Cannot read properties of undefined (reading 'Error')
É o ts.DiagnosticCategory.Error do compilador procurando a API que não existe mais. A mensagem não menciona a versão do TypeScript em lugar nenhum, o que é a pior parte: quem forçar a instalação vai investigar outra coisa.
Com o alias, o ng build funciona e gera o mesmo bundle, com o mesmo hash, que com o 6.0.3 puro. O que o 7 entrega num projeto Angular é o tsc -p tsconfig.app.json --noEmit rápido, que é o que o anúncio recomenda. Só que esse tsc não lê templates. Coloquei um erro de propósito num template do exemplo Angular do rx-state-bridge, um {{ name().toFixed(2) }} num signal de string | null:
$ npx tsc -p tsconfig.app.json --noEmit # 7.0.2
(exit 0)
$ npx ng build
✘ [ERROR] TS2531: Object is possibly 'null'. [plugin angular-compiler]
✘ [ERROR] TS2551: Property 'toFixed' does not exist on type 'string'. Did you mean 'fixed'? [plugin angular-compiler]
O tsc 7 serve como verificação rápida do código TypeScript num pre-commit ou no começo do pipeline. Ele não substitui o ng build nem o ng test como checagem de tipos de um projeto Angular, porque metade dos tipos de um componente mora no template.
Next.js: o next build já roda o tsc como processo
Esse foi o resultado que eu não esperava. O Next.js 16.3.8 (o do vertex-web em 23/10) e o 16.4.2 (o do pyxis-web) já têm a opção experimental.useTypeScriptCli ligada por padrão. Em vez de carregar a API do TypeScript, o next build executa o tsc do projeto como processo separado. A documentação diz que é justamente para suportar o 7 enquanto ele não tem API.
Com typescript@7.0.2 instalado, o next build do vertex-web passou, e um erro de tipo colocado de propósito apareceu do jeito que o tsc imprime, sem o quadro de código que o Next costuma montar:
Running TypeScript ...
src/lib/site-url.ts(20,14): error TS2322: Type 'string' is not assignable to type 'number'.
Failed to type check.
Desligando a opção (useTypeScriptCli: false) com o 7 instalado, o Next para com uma mensagem clara:
TypeScript 7.0.2 does not provide the compiler API required by Next.js. Set experimental.useTypeScriptCli back to true in your Next.js config to use the TypeScript CLI, or install TypeScript 6 instead.
O detalhe que muda a decisão aparece com o alias. O Next procura o tsc lendo o campo bin do pacote que responde por typescript/package.json, e aceita um binário chamado tsc seguido de número. Com o alias, esse pacote é o @typescript/typescript6, o binário é o tsc6, e o next build checa com o 6.0.3. Para provar, coloquei o arquivo do TS7022 da seção anterior dentro do src do vertex-web: com o alias, o next build passou ("Finished TypeScript"), e o npx tsc (o 7) apontou o TS7022 no mesmo código.
Então, num projeto Next.js com typescript-eslint, em 23/10 dá para ter uma de duas coisas: o next build checando com o 7 e o lint quebrado, ou o lint funcionando e o next build checando com o 6. Eu fiquei com a segunda e rodo o tsc 7 como passo separado no CI. Quem quiser o 7 dentro do next build pode desligar a checagem do Next (typescript.ignoreBuildErrors) e deixar só o passo do tsc 7, mas isso tira a rede de segurança de quem roda next build na própria máquina. Não fiz.
Quanto isso vale no next build inteiro: medi com o TypeScript do lock de cada repositório e com o typescript@7.0.2, 5 builds por configuração, .next apagado antes de cada um (mediana, mínimo e máximo, em segundos).
| Projeto | Etapa "Running TypeScript" | next build inteiro |
|---|---|---|
| vertex-web, 5.9.3 | 3,0 (3,0–3,0) | 9,3 (9,2–9,4) |
| vertex-web, 7.0.2 | 0,66 (0,63–0,69) | 7,1 (7,0–7,2) |
| pyxis-web, 6.0.3 | 9,1 (9,0–9,1) | 15,0 (14,9–15,4) |
| pyxis-web, 7.0.2 | 1,75 (1,66–1,77) | 8,1 (7,8–8,2) |
No pyxis-web, o build inteiro caiu quase pela metade, porque a checagem de tipos era mais da metade dele. No vertex-web, a checagem já era a menor parte, e o build ficou só 2 segundos mais curto. É esse ganho que fica de fora quando o alias faz o next build usar o tsc6.
typescript-eslint, ts-jest e Nest CLI: precisam da API, e dizem isso
Os três carregam o compilador como biblioteca. O typescript-eslint, desde a 8.63.0 (06/07, dois dias antes do 7.0), detecta o 7 e para:
typescript-eslint does not support TS 7.0.
Please see https://devblogs.microsoft.com/typescript/announcing-typescript-7-0/#running-side-by-side-with-typescript-6.0 to run typescript-eslint using the TS 6 API.
See also https://github.com/typescript-eslint/typescript-eslint/issues/10940 for tracking typescript-eslint's support for TS >=7.1
A 8.62.1, uma versão antes, não tem essa checagem. No vertex-api, que estava nela, o ESLint caiu com TypeError: Cannot read properties of undefined (reading 'Cjs'), de dentro do @typescript-eslint/typescript-estree, sem dizer o motivo. O peer declarado é typescript >=4.8.4 <6.1.0 em todas elas, e o npm trata isso de dois jeitos. No pyxis-web, onde o typescript-eslint é dependência direta, npm install -D typescript@7.0.2 para com ERESOLVE, igual ao Angular. No vertex-web, onde ele vem dentro do eslint-config-next, o npm só avisa ("overriding peer dependency") e instala, e o problema só aparece quando alguém roda o lint.
O ts-jest 29.4 (peer typescript >=4.3 <7) e o Nest CLI 11.0.24 também explicam o que aconteceu:
The TypeScript compiler "typescript" (version 7.0.2) does not expose the JavaScript compiler API required by ts-jest. To use TypeScript 7 for project type-checking, install it as "@typescript/native" and alias "@typescript/typescript6" as "typescript" for ts-jest.
Error The installed TypeScript version (7.0.2) does not expose the programmatic compiler API that the Nest CLI requires. TypeScript 7.0 ships the "tsc" executable only; the compiler API is expected to return in 7.1. Please install TypeScript 6 (e.g. "npm i -D typescript@^6") until then.
Com o alias, os três voltaram a funcionar. No vertex-api, porém, voltaram a funcionar com o 6.0, e o 6.0 tem os padrões novos. Antes de eu acertar o tsconfig, o ESLint, que roda com regras que usam tipos, acusou 3.554 erros: no-unsafe-call, no-unsafe-member-access e no-unsafe-assignment em todo expect(...) e jest.fn(), porque sem types: ["jest"] esses nomes não têm tipo. As três linhas do tsconfig resolveram o lint junto com o tsc e o Jest. Com elas, o vertex-api ficou com tsc (7), nest build, 248 testes e o lint passando.
tsup: o problema era o baseUrl que ele mesmo injeta
O rx-state-bridge gera os .d.ts com o tsup. Com o 7 direto, a geração de declarações quebrou com Cannot read properties of undefined (reading 'useCaseSensitiveFileNames'), de dentro do rollup-plugin-dts que o tsup embute. Esperado: é mais um consumidor da API.
Com o alias, quebrou de outro jeito:
error TS5101: Option 'baseUrl' is deprecated and will stop functioning in TypeScript 7.0. Specify compilerOption '"ignoreDeprecations": "6.0"' to silence this error.
O tsconfig da biblioteca não tem baseUrl. Quem coloca é o tsup 8.5.1, que monta as opções da geração de declarações com baseUrl: compilerOptions.baseUrl || ".". O tsup 9.0.0, de 14/10, não faz mais isso: com ele e o alias, a geração passou, o JavaScript saiu idêntico byte a byte ao do 5.9.3, e o .d.ts mudou só na forma do export final (o 9 separa export type { ... } numa linha própria).
O que não precisou de nada
O Vitest roda nos dois repositórios de front com o 7 instalado sem perceber a diferença, porque transforma TypeScript sem passar pelo compilador. O mesmo vale para o build do Vite no exemplo React. O pyxis-api compila com tsc -p tsconfig.build.json, então o build de produção dele passou a usar o 7 sem mudar uma linha; o vertex-api compila com nest build, que precisa da API, e continua no 6.
O que muda no dist
Comparei a saída do 6.0.3 com a do 7.0.2 nos dois backends. No pyxis-api, 17 dos 601 arquivos .js ficaram diferentes; no vertex-api, 7 de 90. Em todos, a diferença some quando se ignoram espaços e quebras de linha: o 7 quebra arrays de metadados de decorators em outro ponto. O código é o mesmo.
Os .d.ts mudam mais: 21 arquivos no vertex-api, com propriedades em outra ordem. É o stableTypeOrdering, que o 7 aplica sempre. Para uma aplicação, tanto faz. Para uma biblioteca que versiona as declarações ou compara o dist entre versões, o primeiro diff do 6 para o 7 vai ser grande e não vai significar nada.
Como ficou o package.json
Em todos os repositórios que testei, a configuração que passou em tudo foi a mesma:
{
"devDependencies": {
"@typescript/native": "npm:typescript@^7.0.2",
"typescript": "npm:@typescript/typescript6@^6.0.2"
}
}
O tsc do projeto é o 7, e é ele que roda nos scripts typecheck. Todo o resto (Angular, Next, ESLint, Jest, Nest) recebe o 6, inclusive o ng build e o next build. O ganho fica no passo de typecheck do CI e no pre-commit, que são os dois lugares onde eu mais espero pelo compilador.
Ficou de fora do que eu medi: o editor. O 7 tem servidor de linguagem próprio e não roda plugins de language service, o que inclui o plugin do Next declarado no tsconfig e a checagem de templates do Angular no editor. Não testei nenhum dos dois. E nenhum desses projetos chega perto do tamanho dos que aparecem no anúncio; num monorepo de milhões de linhas, a proporção entre o tempo de iniciar o processo e o tempo de checar muda, e os números acima não dizem nada sobre ela.
Quando o 7.1 sair com a API estável, o alias deixa de ser necessário para quem a adotar. O 7.1.0-beta já tem a API e a correção do TS7022. Até lá, cada ferramenta da lista acima precisa publicar uma versão que use a API nova, e é isso que eu vou acompanhar, uma por uma, antes de tirar o alias.
Comentários
Carregando comentários...