Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

`@netlify/vite-plugin` fails to load under `TypeScript 7` via `ts-api-utils` `TypeFlags` access

Abierto
#65 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
52/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
node.js, typescript, vite

Línea de trabajo

Reproduce el fallo con el proyecto testing-router-with-netlify-plugin enlazado y las versiones indicadas arriba, y después inspecciona la ruta de dependencias a través de precinct, detective-typescript, @typescript-eslint/typescript-estree y ts-api-utils. Empieza por ts-api-utils/lib/index.cjs y la ubicación de la pila en convert-comments.js, y determina si la ruta de dependencias puede evitar la carga o debe actualizarse para TypeScript 7. Se considera terminado cuando vite build carga correctamente la configuración o se documenta el rango de TypeScript compatible.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Summary

@netlify/[email protected] installs successfully in a Vite 8 project, but vite build fails while loading vite.config.mts when the project uses [email protected].

The failure appears to come from the plugin's dependency path through @netlify/dev/@netlify/zip-it-and-ship-it into precinct -> detective-typescript -> @typescript-eslint/typescript-estree -> ts-api-utils. That tooling currently expects the older TypeScript CommonJS API shape.

Environment
node: 24.19.0
npm: 12.0.2
vite: 8.2.0
typescript: 7.0.2
@netlify/vite-plugin: 3.0.1

@netlify/[email protected] declares support for Vite 8 and Node >=22.12.0, so the direct package constraints are satisfied.

Minimal config shape
import netlify from "@netlify/vite-plugin";
import { defineConfig } from "vite";

export default defineConfig({
  plugins: [netlify()],
});
Actual behavior

tsc -b passes, but vite build fails before the app build starts:

failed to load config from /path/to/vite.config.mts
error during build:
TypeError: Cannot read properties of undefined (reading 'Intrinsic')
    at Object.<anonymous> (/path/to/node_modules/ts-api-utils/lib/index.cjs:787:57)
    at Module._compile (node:internal/modules/cjs/loader:1872:14)
    at Object..js (node:internal/modules/cjs/loader:2003:10)
    at Module.load (node:internal/modules/cjs/loader:1594:32)
    at Module._load (node:internal/modules/cjs/loader:1396:12)
    at wrapModuleLoad (node:internal/modules/cjs/loader:255:19)
    at Module.require (node:internal/modules/cjs/loader:1617:12)
    at require (node:internal/modules/helpers:153:16)
    at Object.<anonymous> (/path/to/node_modules/precinct/node_modules/@typescript-eslint/typescript-estree/dist/convert-comments.js:37:30)
Dependency path
@netlify/[email protected]
└─ @netlify/[email protected]
   └─ @netlify/[email protected]
      └─ @netlify/[email protected]
         └─ [email protected]
            └─ [email protected]
               └─ @typescript-eslint/[email protected]
                  └─ [email protected]

@typescript-eslint/[email protected] has a TypeScript peer range of >=4.8.4 <6.1.0. With [email protected], require("typescript") only exposes:

[ 'version', 'versionMajorMinor' ]

So this line in ts-api-utils crashes because TypeFlags is undefined:

ts.TypeFlags.Intrinsic
Expected behavior

One of these would work:

  1. @netlify/vite-plugin does not load the TypeScript-analysis dependency path during ordinary Vite config loading/builds unless needed.
  2. The dependency chain is updated to TypeScript 7-compatible tooling.
  3. The package documents that TypeScript 7 projects are not currently supported, despite the Vite/Node peer constraints being satisfied.

Reproduction

https://github.com/oleksandr-danylchenko/testing-router-with-netlify-plugin

Notes

This is distinct from installation. The package installs cleanly. The runtime failure happens when Vite loads the config containing netlify().

Lenguaje dominante
TypeScript
Estrellas
1
Forks
4
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de netlify/framework-adapters

Todos los issues de netlify/framework-adapters

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.