Generador de tsconfig.json
Generador de tsconfig.json: crea una configuración TypeScript base con target, módulo, strict, include y outDir.
Configuración TypeScript de partida
El generador crea un tsconfig.json con target ES2022, module ESNext, moduleResolution Bundler y strict activado. Usa src y dist como directorios predeterminados, aunque permite cambiar raíz y salida. Include apunta a todos los archivos bajo la raíz indicada.
Qué controlan los directorios
outDir decide dónde coloca TypeScript los archivos emitidos cuando la compilación genera salida. include limita qué rutas entran inicialmente al proyecto. Escribir src y dist produce include «src/**/*» y outDir «dist», pero no crea esas carpetas.
Opciones ligadas al entorno
moduleResolution Bundler encaja con herramientas que resuelven módulos como un bundler moderno. Node, una biblioteca, un framework o código que emite CommonJS pueden necesitar otra combinación. La herramienta no inspecciona package.json ni conoce la versión instalada de TypeScript.
Strict como base de revisión
Activar strict reúne varias comprobaciones y puede revelar errores en un proyecto existente. Eso es útil, pero una migración quizá requiera resolverlos por etapas. No desactives reglas sin entender cada diagnóstico y sin comprobar cómo compila el código completo.
Completar antes de compilar
Revisa lib, types, jsx, noEmit, paths, declaration y opciones del framework según el proyecto. Abre la referencia de TypeScript para cada adición y ejecuta tsc --showConfig para ver la configuración efectiva, incluidas extensiones heredadas.
Relación entre rootDir, include y outDir
La raíz escrita aquí alimenta include, pero el archivo base no declara rootDir explícito. TypeScript puede inferir una raíz común a partir de los archivos incluidos. Si el proyecto incorpora scripts fuera de src, la estructura emitida puede sorprender. Revisa la lista con tsc --listFiles y define rootDir solo cuando entiendas ese efecto. Exclude tampoco sustituye include: ambas listas participan en qué archivos forman el programa. Comprueba archivos de prueba, scripts de configuración y declaraciones globales antes de fijar la raíz definitiva.
Fuentes y referencias
Continúa con estas herramientas
- JSON a CSV
- Conversor YAML a JSON
- Generador de eventos ICS
- Generador de RSS
- Generador de expresiones cron
Preguntas frecuentes
¿Qué ocurre si dejo vacíos los directorios?
El archivo usa src para la entrada incluida y dist como carpeta de salida predeterminada.
¿Bundler funciona en cualquier proyecto Node?
No necesariamente. Depende del runtime y de la herramienta que resuelva módulos; contrástalo con la arquitectura del proyecto.
¿El generador detecta React o Next.js?
No. No inspecciona dependencias ni añade jsx, plugins u opciones recomendadas por un framework.
¿Strict cambia el JavaScript emitido?
Su efecto principal son comprobaciones de tipos. Los errores pueden impedir la compilación según el comando y la configuración.
¿Cómo veo qué opciones termina usando TypeScript?
Ejecuta tsc --showConfig dentro del proyecto para resolver extends y observar la configuración efectiva.
¿El archivo activa noEmit?
No en la base generada. Si tu bundler compila y TypeScript solo comprueba tipos, debes decidir esa opción.
Herramienta de OCC Tools