Qué es tsup

tsup es un empaquetador super rápido de JavaScript y TypeScript construido sobre esbuild. Está pensado para librerías: configuración mínima, excelentes valores por defecto y la capacidad de generar en un solo paso builds ESM y CJS además de las declaraciones de tipos.

Por qué usar tsup

- Velocidad gracias a esbuild como motor subyacente.

- Configuración cero o mínima funciona desde la CLI o con un archivo de configuración muy pequeño.

- Salida dual genera ESM y CJS para máxima compatibilidad.

- Definiciones de tipos puede emitir archivos d.ts activando la opción dts.

- Extras útiles modo watch, minificación, treeshaking, code splitting y sourcemaps.

Inicio rápido

Instalación comando ejemplo npm i -D tsup typescript

Scripts sugeridos en package.json ejemplo scripts build: tsup, dev: tsup --watch, prepare: npm run build

Configuración mínima recomendada para tsup en tsup.config.ts entrada src/index.ts, formatos esm y cjs, dts true para emitir .d.ts, sourcemap true, clean true, target es2020 y treeshake true

tsconfig.json minimal ejemplo opciones compilerOptions target ES2020, moduleResolution bundler, strict true, declaration true, emitDeclarationOnly false, skipLibCheck true e incluir carpeta src

Ejecutar npm run build generará dist/index.mjs dist/index.cjs y dist/index.d.ts

Comparación con otras herramientas

- tsc compila TypeScript a JavaScript pero no hace bundling, tsup empaqueta el código y puede marcar dependencias como externas.

- rollup y webpack son muy flexibles y requieren más configuración; tsup es una alternativa ligera tipo rollup para librerías, rápida y sencilla.

- vite es excelente para aplicaciones y servidores de desarrollo; aunque se puede usar para librerías, tsup suele ser más simple para publicar paquetes.

Cuándo usar y cuándo no

- Usar tsup para publicar librerías rápidamente con builds duales y tipos incluidos.

- Si necesitas bundling exótico con plugins personalizados o objetivos de módulo inusuales, rollup o webpack pueden ser más adecuados.

- Si no quieres bundling en absoluto y prefieres salida por archivo, tsc puede ser suficiente.

Conclusión

tsup es una solución rápida y sencilla para empaquetar librerías con definiciones de tipos integradas, ideal para flujos de trabajo que valoran velocidad y simplicidad.

Sobre Q2BSTUDIO

Q2BSTUDIO es una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida. Ofrecemos soluciones completas en inteligencia artificial y ia para empresas, agentes IA y servicios de ciberseguridad para proteger tus activos digitales. Además brindamos servicios cloud aws y azure, servicios de inteligencia de negocio y consultoría en power bi para transformar datos en decisiones accionables. Nuestro enfoque combina experiencia en desarrollo, despliegue cloud y seguridad para entregar productos escalables y seguros.

Si necesitas ayuda para empaquetar tu librería, integrar pipelines de build, migrar a arquitecturas modernas o aprovechar agentes IA y soluciones de inteligencia de negocio como power bi, Q2BSTUDIO puede apoyarte con consultoría y desarrollo a medida en inteligencia artificial, ciberseguridad, servicios cloud aws y azure y mucho más.