
TypeScript 7 en cinco proyectos reales: tsc es de 3 a 6 veces más rápido y el resto de la cadena sigue en el 6
Dependabot abrió un pull request en el ejemplo de React de rx-state-bridge que llevaba TypeScript del 5.6 directo al 7.0.2, y el build se detuvo en una línea que estaba ahí desde el primer día:
src/main.tsx(4,8): error TS2882: Cannot find module or type declarations for side-effect import of './styles.css'.
Lo corregí con el archivo que ya traen las plantillas de Vite, un vite-env.d.ts con /// <reference types="vite/client" />, y escribí en el commit que TypeScript 7 rechazaba el import. La corrección era buena. La explicación, no: el 7 no inventó esa regla. Corrí el mismo ejemplo, sin el vite-env.d.ts, en tres versiones:
TS 5.9.3 exit 0
TS 6.0.3 TS2882 en './styles.css'
TS 7.0.2 TS2882 en './styles.css'
TS 5.9.3 --noUncheckedSideEffectImports TS2307 en './styles.css'
TS 6.0.3 --noUncheckedSideEffectImports false exit 0
TS 7.0.2 --noUncheckedSideEffectImports false exit 0
El error viene del 6.0, que activó noUncheckedSideEffectImports por defecto. El PR se saltó el 6, y el 7 heredó el valor nuevo. Es el dato que más importa en una migración al 7, y el anuncio oficial lo dice sin rodeos: el 7.0 adopta los valores por defecto del 6.0 y convierte en error todo lo que el 6.0 había marcado como obsoleto.
Con eso en mente, tomé cinco repositorios públicos míos, cada uno en el último commit de main hasta el 23/10/2026, y pasé cada uno por el 5.9, el 6.0 y el 7.0: el chequeo de tipos, el tiempo y cada herramienta que usan además de tsc.
Lo que trae el 7.0 y lo que dejó para el 7.1
El 7.0.2 es la versión latest del paquete typescript desde el 08/07/2026. Es el compilador reescrito en Go, con binario nativo por plataforma (en Windows, un tsc.exe que el paquete descarga como dependencia opcional) y chequeo de tipos en paralelo. El anuncio habla de mejoras típicas de 8 a 12 veces en builds completos.
Lo que no trae es la API de JavaScript. El anuncio es directo: el 7.0 "does not ship with an API", y la nueva API llega en el 7.1. En el paquete se ve así:
$ node -p "require('typescript')"
{ version: '7.0.2', versionMajorMinor: '7.0' }
En el 6.0.3, el mismo require devuelve un objeto con 2.248 claves: createProgram, DiagnosticCategory, el compilador entero. En el 7.0.2 devuelve la versión y nada más. El package.json del 7.0.2 expone una API en typescript/unstable/sync, typescript/unstable/async y compañía, pero con unstable en el nombre, y ninguna de las herramientas que probé usa esas rutas. El 7.1.0-beta, del 20/10, trae la API con su nombre definitivo (typescript/sync, typescript/async, typescript/ast...) y un punto de extensión para Vue, Svelte, MDX y similares.
Toda herramienta que hace require('typescript') para llamar al compilador se rompe con el 7.0. Para ellas, Microsoft publicó el paquete @typescript/typescript6, que reexporta la API del 6.0 e instala un binario llamado tsc6, para que los dos convivan. Vuelvo a él en la parte de la cadena de herramientas.
Los cinco proyectos
| Proyecto | Qué es | TypeScript en el commit del 23/10 | Archivos en el programa (TS 7) | Líneas (TS 7) |
|---|---|---|---|---|
| rx-state-bridge | biblioteca RxJS (npm) | 5.9.3 | 279 | 75.090 |
| vertex-api | API del 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 de Pyxis, NestJS 12 | 6.0.3 | 4.109 | 527.120 |
| pyxis-web | panel de Pyxis, Next.js 16.4 | 6.0.3 | 2.278 | 500.690 |
Las líneas incluyen las declaraciones de node_modules y las libs de TypeScript, que son la mayor parte del programa en cualquier proyecto. Ninguno es grande: el mayor, pyxis-web, tiene unas 110 mil líneas de TypeScript propio. El anuncio mide el 7 en el código de VS Code, Sentry y Playwright; aquí está el tamaño de proyecto que la mayoría mantenemos.
Dos repositorios ya estaban en el 6.0: los de Pyxis, que nacieron en octubre ya con el 6.0.3. Los otros tres estaban en el 5.9. Esa diferencia decidió casi todo lo que vino después.
Cuánto ganó tsc
Chequeo completo (--incremental false), en segundos: mediana de 7 ejecuciones, con mínimo y máximo.
| Proyecto | 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, sin ningún archivo modificado desde la ejecución anterior:
| Proyecto | 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 |
Medí con tsc -p tsconfig.json --noEmit, cada versión sobre el mismo proyecto, intercaladas ejecución por ejecución: 7 ejecuciones por caso, más una descartada para calentar la caché de disco del sistema. "Completo" es con --incremental false, el programa entero revisado desde cero. "Incremental" es con el .tsbuildinfo de una ejecución anterior y ningún archivo modificado, que es lo que pasa cuando corres tsc dos veces seguidas en un proyecto con incremental: true (las cuatro aplicaciones lo tienen). La máquina es un Intel Core i9-13900H (14 núcleos, 20 hilos), 32 GB, Windows 11, Node 24.19.0.
En el chequeo completo, el 7 fue entre 3,3 y 6,3 veces más rápido que el 6. Es bastante menos que los 8 a 12 del anuncio, y --extendedDiagnostics ayuda a ver por qué. En pyxis-web, el 6.0.3 pasa 6,71 s de sus 9,06 s chequeando tipos; es el proyecto donde el chequeo domina, y es donde el 7 ganó más. En vertex-api, el programa tiene 2.774 archivos, casi todos declaraciones de node_modules, y el 7.0.2 pasa 0,35 s chequeando de 0,75 s en total; el resto es leer y analizar esos archivos. Mi lectura: cuanto más del tiempo de un proyecto está en el chequeo, más se acerca a los números del anuncio. Los proyectos pequeños, o hechos sobre todo de declaraciones de terceros, quedan en la franja de 3 a 5 veces.
Del 5.9 al 6.0, el tiempo no cambia: es el mismo compilador en JavaScript con valores por defecto nuevos. Toda la ganancia está en el salto al 7.
El caso incremental es el que más aparece en el día a día, y ahí el 7 fue de 3,8 a 4,8 veces más rápido. En números absolutos, volver a correr tsc sin haber cambiado nada costaba de 1,5 a 2,5 s en las cuatro aplicaciones con el 6.0, y pasó a costar de 0,3 a 0,6 s.
Memoria, según el Memory used de --extendedDiagnostics: en pyxis-web, 912 MiB en el 6.0.3 y 826 MiB en el 7.0.2; en vertex-web, 447 y 293 MiB; en los demás, la misma dirección. El número del 6 es el heap de V8 y el del 7 es el del runtime de Go, así que la comparación es aproximada; no medí el pico del proceso.
Los controles de paralelismo
El 7 chequea tipos con cuatro workers por defecto. La flag --checkers cambia ese número, y --singleThreaded apaga el paralelismo en todo, incluidos el parsing y la emisión. En pyxis-web, el mayor de los cinco, en segundos (mediana de 7, mínimo y máximo):
| Configuración | Tiempo |
|---|---|
--checkers 1 | 2,05 (2,00–2,16) |
--checkers 4 (por defecto) | 1,37 (1,30–1,41) |
--checkers 8 | 1,33 (1,30–1,38) |
--singleThreaded | 2,59 (2,50–2,70) |
Pasar de 4 a 8 checkers casi no cambió nada en un programa de este tamaño, en una máquina de 20 hilos. Incluso con un solo checker, el 7 fue 4,3 veces más rápido que el 6.0.3 (2,05 s contra 8,72 s), porque el parsing y la emisión siguen en paralelo; con --singleThreaded, que lo apaga todo, aún fue 3,4 veces más rápido. Para un runner de CI con dos o cuatro núcleos, eso indica que la ganancia no depende de tener muchos núcleos. No lo medí en un runner real.
En Windows, el tsc del paquete es un script de Node que lanza el tsc.exe con execFileSync. Llamar al tsc.exe directamente, sin Node de por medio, dio una mediana de 1,33 s contra 1,37 s con el tsc normal. Unos 40 ms, que no justifican cambiar los scripts.
Los errores que marcó el 7, y de dónde venían
En los dos proyectos de Pyxis, que ya estaban en el 6.0.3, el 7.0.2 no marcó ningún error nuevo. En la biblioteca y en vertex-web, tampoco. vertex-api, que venía del 5.9.3, pasó de cero a 1.280 errores:
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 (en archivos .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
El 6.0.3, sobre el mismo código, marca 1.278. La diferencia son exactamente los dos TS7022, que tienen su propia sección más abajo. El resto es el 6.0.
types ahora empieza vacío
Hasta el 5.9, TypeScript cargaba solo todo paquete de node_modules/@types. Desde el 6.0, types vale [] por defecto. Los tests de vertex-api usan los globales de Jest (describe, it, expect), que vienen de @types/jest sin ningún import, y 1.275 de los 1.280 errores eran eso: los tres primeros códigos de la lista y los 12 TS7006, que son parámetros de callbacks de Jest que se quedaron sin tipo.
@types/node no hizo falta, y el motivo vale la pena: el código importa node:crypto, node:fs y similares, y las dependencias de Nest referencian los tipos de Node. El paquete entró al programa por los imports. Un global que nadie importa, como los de Jest, no tiene ese camino.
strict ahora es true por defecto
Los tres errores siguientes (TS2564 y TS2345) vienen de strict, que también pasó a ser el valor por defecto en el 6.0. El tsconfig de vertex-api activa las flags estrictas una por una (strictNullChecks, noImplicitAny, strictBindCallApply) y nunca declaró strict. Con el nuevo valor por defecto, strictPropertyInitialization y strictFunctionTypes entraron también. Para la migración escribí "strict": false, que mantiene exactamente el comportamiento del 5.9. Activar el modo estricto completo es otra decisión, con su propio PR.
rootDir ahora es la carpeta del tsconfig
Este no dio error en tsc. Dio error en Jest. Con el tsconfig original y la API del 6.0, los 30 archivos de test fallaron antes de correr:
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.
ts-jest compila cada archivo de test con el tsconfig del proyecto, que tiene outDir. Hasta el 5.9, rootDir se infería a partir de los archivos. En el 6.0 es la carpeta del tsconfig, y el compilador exige declararlo cuando los archivos de entrada no coinciden con esa carpeta. En el build de Nest, la estructura de salida no cambió: el tsconfig.build.json ya incluía el drizzle.config.ts de la raíz, así que la salida ya era dist/src/main.js en el 5.9 y siguió igual en el 6 y el 7 (comparé la lista de archivos emitidos en las tres versiones). Declarar "rootDir": "./" resolvió Jest sin tocar el build.
La migración del tsconfig entera cupo en tres líneas:
"outDir": "./dist",
+ "rootDir": "./",
+ "types": ["node", "jest"],
+ "strict": false,
"incremental": true,
Con ellas, el 6.0.3 pasa sin errores. El 7.0.2 todavía marca dos.
Los dos errores que solo marca el 7.0.2
Los dos TS7022 aparecieron en una función que pagina el Parameter Store de AWS en un do/while. El 6.0.3 no se queja, ni siquiera con --stableTypeOrdering, la flag que hace que el 6 ordene los tipos como el 7. El 7.0.2 se queja con cualquier número de checkers, incluso con --singleThreaded. Así que no es el orden de chequeo.
Lo reduje hasta llegar a un archivo sin ninguna dependencia:
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
(sin salida, 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
(sin salida, exit 0)
Ahí no hay ninguna circularidad. Los ingredientes son un parámetro de tipo unión acotado antes del bucle (prefix), una llamada genérica que usa ese parámetro dentro del bucle y un acceso por índice comparado dentro del mismo bucle. La misma familia aparece en el issue #4673 de typescript-go, abierto el 19/07: la causa era una función portada del compilador anterior (isMatchingConstructorReference) que quedó más amplia que la original. La corrección entró el 21/07, después del 7.0.2, y llegó al 7.1.0-beta, que compila el archivo de arriba sin errores.
Hasta que el 7.1 sea estable, la salida es anotar el tipo. En vertex-api, una línea:
const page: GetParametersByPathCommandOutput = await client.send(
new GetParametersByPathCommand({ /* ... */ }),
);
Un error que solo marca la versión nueva, en código que no cambió, merece una reducción antes de convertirse en un cambio de código. Aquí la anotación era inofensiva; reducirlo fue lo que mostró que el problema estaba en el compilador.
Lo que el 7 convierte en error
Si todavía estás en el 5.x, la lista del anuncio del 7.0 es tu checklist. Valores por defecto que cambiaron en el 6.0 y valen en el 7.0: strict: true, module: esnext, target en la versión estable más reciente de ECMAScript, noUncheckedSideEffectImports: true, libReplacement: false, stableTypeOrdering: true (sin forma de apagarlo), rootDir en la carpeta del tsconfig y types: []. Y lo que estaba obsoleto en el 6.0 es error en el 7.0, sin ignoreDeprecations que lo salve:
target: es5ydownlevelIteration;moduleResolution: node(onode10) ymoduleResolution: classic;module: amd,umd,systemjsynone;baseUrl(lospathspasan a ser relativos al tsconfig);esModuleInterop: false,allowSyntheticDefaultImports: falseyalwaysStrict: false;moduleen lugar denamespacepara declarar namespaces;assertsen imports (eswith);/// <reference no-default-lib />bajoskipDefaultLibCheck;- archivos en la línea de comandos cuando hay un
tsconfig.jsonen la carpeta, salvo que pases--ignoreConfig(por eso el--ignoreConfigen los comandos de arriba).
El camino que recomienda el propio equipo de TypeScript es pasar antes por el 6.0. Mis números coinciden: en los dos proyectos que ya estaban en el 6, el 7 no pidió nada.
La cadena de herramientas
tsc es la parte fácil. Instalé typescript@7.0.2 en lugar del anterior en cada repositorio y corrí lo que el package.json de cada uno corre en CI:
| Herramienta | Con typescript@7.0.2 | Con el alias del 6 + @typescript/native |
|---|---|---|
tsc (typecheck, build de pyxis-api) | funciona | funciona (es el 7) |
ng build (Angular 22.2) | npm install lo rechaza; forzado, se rompe | funciona, en el 6.0.3 |
next build (Next.js 16.3.8 y 16.4.2) | funciona, chequea con el tsc 7 | funciona, chequea con el tsc6 |
| typescript-eslint 8.x | se rompe | funciona |
| ts-jest 29.4 | se rompe | funciona |
nest build (Nest CLI 11) | se rompe | funciona |
tsup 8.5.1 (generación de .d.ts) | se rompe | se rompe; el 9.0.0 funciona |
| Vitest | funciona | funciona |
"El alias" es la receta oficial del anuncio:
npm install -D "typescript@npm:@typescript/typescript6@^6.0.2" "@typescript/native@npm:typescript@^7.0.2"
Con ella, typescript apunta al paquete de compatibilidad, y toda herramienta que hace require('typescript') recibe la API del 6. El 7 queda en @typescript/native, y npx tsc pasa a ser el suyo. El resultado, en uno de los repositorios:
$ npx tsc -v
Version 7.0.2
$ npx tsc6 -v
Version 6.0.3
$ node -p "require('typescript').version"
6.0.3
@typescript/typescript6 está en la versión 6.0.2, pero es un envoltorio: depende de typescript@^6 e instaló el 6.0.3. El tsserver que aparece en node_modules/.bin también es el del 6.0.3.
Angular: el 7 se queda fuera de ng build
@angular/compiler-cli 22.2.3 y @angular/build 22.2.4 declaran typescript como peer en >=6.0 <6.1. npm se lo toma en serio:
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
Con --legacy-peer-deps se instala, y ng build se rompe en cuanto intenta leer el tsconfig:
✘ [ERROR] Angular compilation initialization failed. [plugin angular-compiler]
TypeError: Cannot read properties of undefined (reading 'Error')
Es el ts.DiagnosticCategory.Error del compilador buscando una API que ya no existe. El mensaje no menciona la versión de TypeScript en ningún lado, y eso es lo peor: quien fuerce la instalación va a investigar otra cosa.
Con el alias, ng build funciona y genera el mismo bundle, con el mismo hash, que con el 6.0.3 puro. Lo que el 7 le da a un proyecto Angular es un tsc -p tsconfig.app.json --noEmit rápido, que es lo que recomienda el anuncio. Pero ese tsc no lee templates. Puse un error a propósito en un template del ejemplo de Angular de rx-state-bridge, un {{ name().toFixed(2) }} sobre un 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]
El tsc 7 sirve como chequeo rápido del código TypeScript en un pre-commit o al inicio del pipeline. No reemplaza a ng build ni a ng test como chequeo de tipos de un proyecto Angular, porque la mitad de los tipos de un componente vive en el template.
Next.js: next build ya corre tsc como proceso
Este fue el resultado que no esperaba. Next.js 16.3.8 (el de vertex-web el 23/10) y 16.4.2 (el de pyxis-web) ya traen la opción experimental.useTypeScriptCli activada por defecto. En lugar de cargar la API de TypeScript, next build ejecuta el tsc del proyecto como proceso aparte. La documentación dice que es justamente para soportar el 7 mientras no tenga API.
Con typescript@7.0.2 instalado, el next build de vertex-web pasó, y un error de tipos puesto a propósito salió tal como lo imprime tsc, sin el recuadro de código que suele armar Next:
Running TypeScript ...
src/lib/site-url.ts(20,14): error TS2322: Type 'string' is not assignable to type 'number'.
Failed to type check.
Al apagar la opción (useTypeScriptCli: false) con el 7 instalado, Next se detiene con un mensaje claro:
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.
El detalle que cambia la decisión aparece con el alias. Next busca tsc leyendo el campo bin del paquete que responde por typescript/package.json, y acepta un binario llamado tsc seguido de un número. Con el alias, ese paquete es @typescript/typescript6, el binario es tsc6, y next build chequea con el 6.0.3. Para probarlo, puse el archivo del TS7022 de la sección anterior dentro del src de vertex-web: con el alias, next build pasó ("Finished TypeScript"), y npx tsc (el 7) marcó el TS7022 en el mismo código.
Entonces, en un proyecto Next.js con typescript-eslint, al 23/10 puedes tener una de dos cosas: next build chequeando con el 7 y el lint roto, o el lint funcionando y next build chequeando con el 6. Me quedé con la segunda y corro el tsc 7 como paso aparte en el CI. Si quieres el 7 dentro de next build, puedes apagar el chequeo de Next (typescript.ignoreBuildErrors) y dejar solo el paso del tsc 7, pero eso quita la red de seguridad a quien corra next build en su máquina. No lo hice.
Cuánto vale eso en el next build completo: medí con el TypeScript del lock de cada repositorio y con typescript@7.0.2, 5 builds por configuración, borrando .next antes de cada uno (mediana, mínimo y máximo, en segundos).
| Proyecto | Etapa "Running TypeScript" | next build completo |
|---|---|---|
| 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) |
En pyxis-web, el build completo bajó casi a la mitad, porque el chequeo de tipos era más de la mitad. En vertex-web, el chequeo ya era la parte menor, y el build quedó solo 2 segundos más corto. Esa es la ganancia que se pierde cuando el alias hace que next build use tsc6.
typescript-eslint, ts-jest y Nest CLI: necesitan la API, y lo dicen
Los tres cargan el compilador como biblioteca. typescript-eslint, desde la 8.63.0 (06/07, dos días antes del 7.0), detecta el 7 y se detiene:
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
La 8.62.1, una versión antes, no tiene ese chequeo. En vertex-api, que estaba en ella, ESLint cayó con TypeError: Cannot read properties of undefined (reading 'Cjs'), desde dentro de @typescript-eslint/typescript-estree, sin decir el motivo. El peer declarado es typescript >=4.8.4 <6.1.0 en todas, y npm lo trata de dos formas. En pyxis-web, donde typescript-eslint es dependencia directa, npm install -D typescript@7.0.2 se detiene con ERESOLVE, igual que Angular. En vertex-web, donde llega dentro de eslint-config-next, npm solo avisa ("overriding peer dependency") e instala, y el problema solo aparece cuando alguien corre el lint.
ts-jest 29.4 (peer typescript >=4.3 <7) y Nest CLI 11.0.24 también explican lo que pasó:
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.
Con el alias, los tres volvieron a funcionar. En vertex-api, eso sí, volvieron a funcionar con el 6.0, y el 6.0 tiene los valores por defecto nuevos. Antes de ajustar el tsconfig, ESLint, que corre reglas con información de tipos, reportó 3.554 errores: no-unsafe-call, no-unsafe-member-access y no-unsafe-assignment en cada expect(...) y jest.fn(), porque sin types: ["jest"] esos nombres no tienen tipo. Las tres líneas del tsconfig resolvieron el lint junto con tsc y Jest. Con ellas, vertex-api quedó con tsc (7), nest build, 248 tests y el lint pasando.
tsup: el problema era el baseUrl que él mismo inyecta
rx-state-bridge genera sus .d.ts con tsup. Con el 7 instalado directamente, la generación de declaraciones se rompió con Cannot read properties of undefined (reading 'useCaseSensitiveFileNames'), desde dentro del rollup-plugin-dts que tsup incluye. Esperable: es un consumidor más de la API.
Con el alias, se rompió de otra forma:
error TS5101: Option 'baseUrl' is deprecated and will stop functioning in TypeScript 7.0. Specify compilerOption '"ignoreDeprecations": "6.0"' to silence this error.
El tsconfig de la biblioteca no tiene baseUrl. Quien lo pone es tsup 8.5.1, que arma las opciones de la generación de declaraciones con baseUrl: compilerOptions.baseUrl || ".". tsup 9.0.0, del 14/10, ya no lo hace: con él y el alias, la generación pasó, el JavaScript salió idéntico byte a byte al del 5.9.3, y el .d.ts cambió solo en la forma del export final (el 9 separa export type { ... } en su propia línea).
Lo que no necesitó nada
Vitest corre en los dos repositorios de front con el 7 instalado sin notar la diferencia, porque transforma TypeScript sin pasar por el compilador. Lo mismo vale para el build de Vite en el ejemplo de React. pyxis-api compila con tsc -p tsconfig.build.json, así que su build de producción pasó a usar el 7 sin cambiar una línea; vertex-api compila con nest build, que necesita la API, y sigue en el 6.
Lo que cambia en dist
Comparé la salida del 6.0.3 con la del 7.0.2 en los dos backends. En pyxis-api, 17 de 601 archivos .js quedaron distintos; en vertex-api, 7 de 90. En todos, la diferencia desaparece si se ignoran espacios y saltos de línea: el 7 corta los arrays de metadatos de decorators en otro punto. El código es el mismo.
Los .d.ts cambian más: 21 archivos en vertex-api, con propiedades en otro orden. Es stableTypeOrdering, que el 7 aplica siempre. Para una aplicación, da igual. Para una biblioteca que versiona sus declaraciones o compara el dist entre versiones, el primer diff del 6 al 7 va a ser grande y no va a significar nada.
Cómo quedó el package.json
En todos los repositorios que probé, la configuración que pasó todo fue la misma:
{
"devDependencies": {
"@typescript/native": "npm:typescript@^7.0.2",
"typescript": "npm:@typescript/typescript6@^6.0.2"
}
}
El tsc del proyecto es el 7, y es el que corre en los scripts typecheck. Todo lo demás (Angular, Next, ESLint, Jest, Nest) recibe el 6, incluidos ng build y next build. La ganancia queda en el paso de typecheck del CI y en el pre-commit, que son los dos lugares donde más espero al compilador.
Lo que no medí: el editor. El 7 tiene su propio servidor de lenguaje y no corre plugins del language service, lo que incluye el plugin de Next declarado en el tsconfig y el chequeo de templates de Angular en el editor. No probé ninguno de los dos. Y ninguno de estos proyectos se acerca al tamaño de los del anuncio; en un monorepo de millones de líneas, la proporción entre el tiempo de arrancar el proceso y el de chequear cambia, y los números de arriba no dicen nada sobre eso.
Cuando salga el 7.1 con la API estable, el alias deja de ser necesario para las herramientas que la adopten. El 7.1.0-beta ya tiene la API y la corrección del TS7022. Hasta entonces, cada herramienta de la lista de arriba tiene que publicar una versión que use la API nueva, y eso es lo que voy a seguir, una por una, antes de quitar el alias.
Comentarios
Cargando comentarios...