typescript-runtime

TypeScript Runtime

Skill para configurar y mantener toolchains TypeScript modernos: tsconfig estricto, ESLint con typescript-eslint, Prettier, Vitest, bundling, gestión de tipos y estándares de proyecto.

Principios fundamentales

• strict: true obligatorio en tsconfig. Sin excepciones.
• Nunca usar any. Usar unknown + type guards cuando el tipo es desconocido.
• ESLint con @typescript-eslint/parser + Prettier como estándar.
• Vitest como test runner (soporte nativo de TypeScript, rápido, ESM).
• Tipos explícitos en interfaces públicas (funciones exportadas, props de componentes). Inferencia para variables locales.

tsconfig.json recomendado

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitOverride": true,
    "noPropertyAccessFromIndexSignature": true,
    "exactOptionalPropertyTypes": false,
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "skipLibCheck": true,
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true,
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*.ts"],
  "exclude": ["node_modules", "dist", "**/*.test.ts"]
}

Estructura de proyecto recomendada

proyecto/
├── src/
│   ├── handlers/
│   ├── services/
│   ├── repositories/
│   ├── types/              # Tipos e interfaces compartidos
│   │   └── index.ts
│   ├── utils/
│   └── index.ts
├── tests/
│   ├── unit/
│   ├── integration/
│   └── helpers/
│       └── fixtures.ts
├── tsconfig.json
├── eslint.config.mjs
├── .prettierrc
├── vitest.config.ts
├── package.json
└── README.md

ESLint con typescript-eslint (flat config, v9+)

// eslint.config.mjs
import eslint from '@eslint/js';
import tseslint from 'typescript-eslint';

export default tseslint.config(
  eslint.configs.recommended,
  ...tseslint.configs.strictTypeChecked,
  {
    languageOptions: {
      parserOptions: {
        projectService: true,
        tsconfigRootDir: import.meta.dirname,
      },
    },
    rules: {
      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
      '@typescript-eslint/no-explicit-any': 'error',
      '@typescript-eslint/explicit-function-return-type': ['warn', {
        allowExpressions: true,
        allowTypedFunctionExpressions: true,
      }],
      '@typescript-eslint/strict-boolean-expressions': 'error',
      '@typescript-eslint/no-floating-promises': 'error',
      'no-console': ['warn', { allow: ['warn', 'error'] }],
    },
  },
  { ignores: ['dist/', 'node_modules/', 'coverage/'] },
);