Empaquetado (Pack)

vp pack construye librerías para producción con tsdown.

Vista General

vp pack construye librerías y ejecutables independientes con tsdown. Úsalo para paquetes publicables y salidas binarias. Si quieres construir una aplicación web, usa vp build. vp pack cubre todo lo que necesitas para construir librerías de forma nativa, incluyendo la generación de archivos de declaración, múltiples formatos de salida, mapas de fuente (source maps) y minificación.

Para más información sobre cómo funciona tsdown, consulta la guía oficial de tsdown.

Uso

vp pack
vp pack src/index.ts --dts
vp pack --watch

Configuración

Coloca la configuración de empaquetado directamente en el bloque pack en vite.config.ts para que toda tu configuración permanezca en un solo lugar. No recomendamos usar tsdown.config.ts con Vite+.

Consulta la guía de tsdown y la documentación del archivo de configuración de tsdown para aprender más sobre cómo usar y configurar vp pack.

Úsalo para:

• archivos de declaración (dts)
• formatos de salida
• modo escucha (watch)
• ejecutables independientes

vite.config.ts

import { defineConfig } from 'vite-plus';

export default defineConfig({
  pack: {
    dts: true,
    format: ['esm', 'cjs'],
    sourcemap: true,
  },
});

Ejecutables Independientes

vp pack también puede construir ejecutables independientes a través de la opción experimental exe de tsdown.

Usa esto cuando quieras distribuir un CLI u otra herramienta basada en Node como un ejecutable nativo que funcione sin necesidad de tener Node.js instalado por separado.

vite.config.ts

import { defineConfig } from 'vite-plus';

export default defineConfig({
  pack: {
    entry: ['src/cli.ts'],
    exe: true,
  },
});

El soporte para ejecutables está integrado en Vite+, por lo que no necesitas instalar @tsdown/exe por separado.

La compilación de ejecutables utiliza el soporte para aplicaciones ejecutables únicas (Single Executable Applications) de Node y requiere Node.js 25.7.0 o posterior. Cambia el entorno de ejecución activo con vp env use 26 si vp pack --exe informa de una versión no compatible.

Consulta la documentación oficial de ejecutables de tsdown para obtener detalles sobre la configuración de nombres de archivo personalizados, activos embebidos y objetivos multiplataforma.

Empaquetado de CSS

vp pack puede transformar y empaquetar CSS (incluyendo CSS Modules y optimizaciones de Lightning CSS) para tus puntos de entrada. Este soporte está integrado en Vite+, por lo que no necesitas instalar @tsdown/css o lightningcss por separado; funciona de inmediato.