Команда vp pack

vp pack собирает библиотеки для продакшена с помощью tsdown.

Обзор

vp pack собирает библиотеки и автономные исполняемые файлы с помощью tsdown. Используйте его для пакетов, предназначенных для публикации, и бинарных файлов. Если вам нужно собрать веб-приложение, используйте vp build. vp pack включает всё необходимое для сборки библиотек из коробки, включая генерацию файлов деклараций, несколько форматов вывода, карты исходного кода и минификацию.

Подробнее о работе tsdown см. в официальном руководстве по tsdown.

Использование

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

Конфигурация

Размещайте настройки упаковки непосредственно в блоке pack файла vite.config.ts, чтобы вся конфигурация находилась в одном месте. Мы не рекомендуем использовать tsdown.config.ts вместе с Vite+.

Подробнее об использовании и настройке vp pack см. в руководстве по tsdown и документации по файлу конфигурации tsdown.

Используйте его для настройки:

• файлов деклараций (dts)
• форматов вывода
• режима наблюдения
• автономных исполняемых файлов

vite.config.ts

import { defineConfig } from 'vite-plus';

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

Автономные исполняемые файлы

vp pack также может собирать автономные исполняемые файлы с помощью экспериментальной опции exe из tsdown.

Используйте эту возможность, если хотите распространять CLI или другой инструмент на базе Node.js в виде нативного исполняемого файла, который может запускаться без отдельной установки Node.js.

vite.config.ts

import { defineConfig } from 'vite-plus';

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

Поддержка создания исполняемых файлов встроена в Vite+, поэтому отдельно устанавливать @tsdown/exe не требуется.

Сборка исполняемых файлов использует поддержку Single Executable Applications в Node.js и требует Node.js версии 25.7.0 или новее. Если команда vp pack --exe сообщает о неподдерживаемой версии, переключите активную среду выполнения с помощью vp env use 26.

Подробную информацию о настройке пользовательских имён файлов, встроенных ресурсов и кроссплатформенных целевых платформ см. в официальной документации по исполняемым файлам tsdown.

Объединение CSS

Команда vp pack может преобразовывать и объединять CSS (включая CSS-модули и оптимизации с помощью Lightning CSS) для ваших точек входа. Эта возможность встроена в Vite+, поэтому отдельно устанавливать @tsdown/css или lightningcss не требуется — всё работает «из коробки».