Archivo tsconfig.node.json #

Este archivo es una configuración de TypeScript específica para el código que se ejecuta en el entorno de Node.js dentro de tu proyecto. En el contexto de una aplicación frontend construida con Vite, este archivo es principalmente responsable de configurar TypeScript para el archivo de configuración de Vite (vite.config.ts) y cualquier otro script de Node.js que puedas tener.

• Descripción: tsconfig.node.json extiende la configuración base de TypeScript y adapta las opciones del compilador para el entorno Node.js. Se enfoca en un target moderno, librerías adecuadas para Node, y reglas estrictas de tipado, al mismo tiempo que se integra con las necesidades de Vite.
• Propósito:
  • Tipado para Node.js: Asegurar que el código TypeScript que se ejecuta en Node.js (como vite.config.ts u otros scripts de build/utilidades) esté correctamente tipado y compilado.
  • Integración con Vite: Proporcionar una configuración compatible para que Vite pueda procesar archivos TypeScript.
  • Separación de Preocupaciones: Distinguir la configuración de compilación del código del frontend (que usa tsconfig.app.json) de la configuración del código de Node.js.
• Secciones Clave:
  • compilerOptions: Contiene todas las opciones para el compilador de TypeScript en este contexto.
    • tsBuildInfoFile: Ruta a un archivo donde TypeScript guarda información de compilación para construcciones incrementales.
    • target: "ES2022": Soporte para sintaxis moderna de JavaScript (ES2022).
    • lib: ["ES2023"]: Incluye las APIs más recientes de JavaScript estándar para el tipado.
    • module: "ESNext": Soporte para el sistema de módulos más reciente de JavaScript (ESM), que es el preferido en Node.js moderno.
    • skipLibCheck: true: Ignora la verificación de tipos para los archivos de definición de librerías (.d.ts), lo que puede acelerar la compilación.
    • /* Bundler mode */: Agrupa opciones relacionadas con el modo en que el código será procesado por un bundler.
    • moduleResolution: "bundler": Resolución de módulos optimizada para bundlers como Vite.
    • allowImportingTsExtensions: true: Permite importar archivos con extensiones .ts o .tsx.
    • isolatedModules: true: Asegura que cada archivo se compile como un módulo independiente, crucial para herramientas como Vite que procesan archivos de forma aislada.
    • moduleDetection: "force": Fuerza a TypeScript a detectar y tratar todos los archivos como módulos.
    • noEmit: true: Crucial: Indica a TypeScript que no debe generar archivos JavaScript de salida. En este setup, Vite es quien se encarga de la transpilación y el bundling final.
    • /* Linting */: Agrupa opciones de rigurosidad.
    • strict: true: Activa todas las comprobaciones estrictas de TypeScript para una mayor seguridad de tipos.
    • noUnusedLocals: true: Detecta variables locales no utilizadas.
    • noUnusedParameters: true: Detecta parámetros de función no utilizados.
    • noFallthroughCasesInSwitch: Advierte sobre casos de switch sin break o return.
    • /* Incremental Build */: Agrupa opciones de compilación incremental.
    • incremental: true: Habilita la compilación incremental, lo que significa que el compilador solo recompila los archivos que han cambiado, acelerando el proceso.
  • include: Define qué archivos debe incluir el compilador en este proyecto.
    • "vite.config.ts": Incluye únicamente el archivo de configuración de Vite, lo que confirma que esta configuración es principalmente para él.
  • exclude: Define qué archivos o carpetas deben ser explícitamente excluidos del proceso de compilación.
    • "node_modules", "dist": Excluye estas carpetas comunes que no son código fuente primario para la compilación.
• Rol en el Proyecto: tsconfig.node.json es una pieza fundamental en la configuración del entorno de desarrollo para un proyecto Vite con TypeScript. Asegura que las herramientas de construcción y los scripts de Node.js operen correctamente con el código TypeScript.

{
  "compilerOptions": {
    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
    "target": "ES2022",
    "lib": ["ES2023"],
    "module": "ESNext",
    "skipLibCheck": true,

    /* Bundler mode */
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "isolatedModules": true,
    "moduleDetection": "force",
    "noEmit": true,

    /* Linting */
    "strict": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noFallthroughCasesInSwitch": true,

    /* Incremental Build */
    "incremental": true
  },
  "include": ["vite.config.ts"],
  "exclude": ["node_modules", "dist"]
}