TypeScript en desarrollo para FiveM
TypeScript se está adoptando cada vez más en el desarrollo de FiveM por las ventajas que ofrece sobre Lua tradicional: tipado estático, mejor autocompletado en editores, detección de bugs en tiempo de compilación y refactorizaciones seguras. Los desarrolladores con background web están más cómodos con TypeScript que con Lua, y proyectos grandes se benefician significativamente de la estructura que aporta.
Configurar el entorno
Usa un scaffolding moderno con Vite o webpack que compile TypeScript a JavaScript compatible con FiveM. La estructura típica separa client, server y shared en directorios distintos, cada uno con su tsconfig.json. Instala @citizenfx/client y @citizenfx/server como devDependencies para obtener los tipos de las natives y APIs de FiveM. Los scripts npm compilan y copian el output a la carpeta del recurso lista para uso.
Tipos para natives
Los paquetes oficiales de tipos cubren la mayoría de natives, pero hay huecos. Cuando encuentres uno sin tipo, puedes declarar el tipo manualmente usando declare global o extender los tipos existentes. La comunidad mantiene definiciones de tipos actualizadas que cubren la mayoría del ecosistema. Para frameworks específicos como ox_lib, hay paquetes con tipos oficiales.
Build y bundling
La configuración de build compila TypeScript, resuelve imports y genera archivos JavaScript listos para ser cargados por FiveM. Vite es rápido y tiene HMR (hot module replacement) en desarrollo. webpack es más tradicional pero muy configurable. Para la mayoría de proyectos, Vite es la opción recomendada. El output suele ser un único bundle por entry point (client.js, server.js) con dependencias resueltas.
Ventajas prácticas
Con TypeScript, errores como propiedades mal escritas, tipos inconsistentes o funciones llamadas con argumentos incorrectos se detectan antes de ejecutar. El editor VS Code muestra documentación al hover y auto-completa nombres de natives. Refactorizar es seguro porque renombrar un símbolo actualiza todas sus referencias. Para proyectos grandes con muchos archivos y desarrolladores, TypeScript es casi indispensable.