Начало работы

🚧 Бета-версия

Rolldown сейчас находится в бета-версии. Хотя он уже может обрабатывать большинство задач продакшн-уровня, в нём всё ещё могут быть ошибки и недоработки.

Установка

Существует несколько способов начать работу с tsdown:

• Установить вручную в качестве зависимости для разработки в вашем проекте.
• Использовать стартовые шаблоны для быстрого создания структуры нового проекта.
• Попробовать онлайн с помощью StackBlitz.

Ручная установка

Установите tsdown как зависимость разработки, используя ваш предпочитаемый менеджер пакетов:

npm

npm install -D tsdown

pnpm

pnpm add -D tsdown

yarn

yarn add -D tsdown

bun

bun add -D tsdown

При желании, если вы не используете isolatedDeclarations, вам также следует установить TypeScript в качестве зависимости для разработки:

npm

npm install -D typescript

pnpm

pnpm add -D typescript

yarn

yarn add -D typescript

bun

bun add -D typescript

Примечание о совместимости

tsdown требует Node.js версии 20.19 или выше. Пожалуйста, убедитесь, что ваша среда разработки соответствует этому требованию перед установкой. Хотя tsdown в основном тестируется с Node.js, поддержка Deno и Bun является экспериментальной и может работать не так, как ожидается.

Прекращение поддержки Node.js

Версии Node.js ниже 22.18.0 объявлены устаревшими, и их поддержка будет прекращена в следующем минорном релизе. Обновите Node.js до версии 22.18.0 или выше.

Стартовые шаблоны

Для ещё более быстрого начала работы вы можете использовать CLI-инструмент create-tsdown, который предоставляет набор стартовых шаблонов для создания библиотек на чистом TypeScript, а также фронтенд-библиотек для React и Vue.

npm

npm create tsdown@latest

pnpm

pnpm create tsdown@latest

yarn

yarn create tsdown@latest

bun

bun create tsdown@latest

Эти шаблоны включают готовые к использованию конфигурации и лучшие практики для сборки, тестирования и проверки кода TypeScript-проектов.

Попробуйте онлайн

Вы можете попробовать tsdown прямо в браузере с помощью StackBlitz:

Этот шаблон уже настроен для tsdown, поэтому вы можете экспериментировать и начать работу быстро — никакой локальной настройки не требуется.

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

Чтобы убедиться, что tsdown установлен правильно, выполните следующую команду в директории вашего проекта:

./node_modules/.bin/tsdown --version

Вы также можете изучить доступные параметры CLI и примеры с помощью:

./node_modules/.bin/tsdown --help

Ваш первый бандл

Давайте создадим два исходных файла TypeScript:

src/index.ts

import { hello } from './hello.ts'

hello()

src/hello.ts

export function hello() {
  console.log('Hello tsdown!')
}

Затем создайте файл конфигурации tsdown:

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  entry: ['./src/index.ts'],
})

Теперь выполните следующую команду, чтобы собрать ваш код:

./node_modules/.bin/tsdown

Вы должны увидеть собранный файл в dist/index.mjs. Чтобы убедиться, что всё работает, запустите этот файл:

node dist/index.mjs

Вы должны увидеть сообщение Hello tsdown!, выведенное в консоль.

Использование CLI в скриптах npm

Для упрощения команды вы можете добавить её в скрипты вашего package.json:

package.json

{
  "name": "my-tsdown-project",
  "type": "module",
  "scripts": {
    "build": "tsdown"
  },
  "devDependencies": {
    "tsdown": "^0.9.0"
  }
}

Теперь вы можете собрать свой проект с помощью:

npm run build

Использование файла конфигурации

Хотя вы можете использовать CLI напрямую, для более сложных проектов рекомендуется использовать конфигурационный файл. Это позволяет вам определять и управлять настройками сборки централизованно и многоразово.

Для получения более подробной информации обратитесь к документации по файлу конфигурации.

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

tsdown поддерживает плагины для расширения его функциональности. Вы можете использовать плагины Rolldown, Unplugin и большинство плагинов Rollup без проблем. Чтобы использовать плагины, добавьте их в массив plugins в вашем файле конфигурации. Например:

tsdown.config.ts

import SomePlugin from 'some-plugin'
import { defineConfig } from 'tsdown'

export default defineConfig({
  plugins: [SomePlugin()],
})

Для получения более подробной информации обратитесь к документации по плагинам.

Использование режима наблюдения (Watch Mode)

Вы можете включить режим наблюдения для автоматической пересборки вашего проекта при изменении файлов. Это особенно полезно во время разработки для оптимизации вашего рабочего процесса. Используйте параметр --watch (или -w):

tsdown --watch

Для получения более подробной информации обратитесь к документации по режиму наблюдения.