Файл конфигурации

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

• tsdown.config.ts
• tsdown.config.mts
• tsdown.config.cts
• tsdown.config.js
• tsdown.config.mjs
• tsdown.config.cjs
• tsdown.config.json
• tsdown.config Кроме того, вы можете определить свою конфигурацию непосредственно в поле tsdown вашего файла package.json.

Написание файла конфигурации

Файл конфигурации позволяет определять и настраивать параметры сборки централизованно и с возможностью повторного использования. Ниже приведен простой пример файла конфигурации tsdown:

import { defineConfig } from 'tsdown/config'
export default defineConfig({
  entry: 'src/index.ts',
})

Создание нескольких выходных файлов

tsdown также поддерживает возврат массива конфигураций из файла конфигурации. Это позволяет создавать несколько выходных файлов с разными настройками за один запуск. Например:

import { defineConfig } from 'tsdown/config'
export default [
  defineConfig({
    entry: 'src/entry1.ts',
    platform: 'node',
  }),
  defineConfig({
    entry: 'src/entry2.ts',
    platform: 'browser',
  }),
]

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

Если ваш файл конфигурации находится в другом месте или имеет другое имя, вы можете указать его путь с помощью опции --config (или -c):

tsdown --config ./path/to/config

Отключение файла конфигурации

Чтобы полностью отключить загрузку файла конфигурации, используйте опцию --no-config:

tsdown --no-config

Это полезно, если вы хотите полагаться исключительно на параметры командной строки или настройки по умолчанию.

Расширение конфигурации Vite или Vitest (экспериментально)

tsdown предоставляет экспериментальную функцию для расширения существующих файлов конфигурации Vite или Vitest. Это позволяет повторно использовать определенные параметры конфигурации, такие как resolve и plugins, игнорируя другие, не относящиеся к tsdown.

Чтобы включить эту функцию, используйте опцию --from-vite:

tsdown --from-vite        # Загрузить vite.config.*
tsdown --from-vite vitest # Загрузить vitest.config.*

Эта функция является **экспериментальной** и может не поддерживать все параметры конфигурации Vite или Vitest. Повторно используются только определенные опции, такие как `resolve` и `plugins`. Используйте с осторожностью и тщательно тестируйте в своем проекте.

Расширение конфигураций Vite или Vitest может сэкономить время и усилия, если ваш проект уже использует эти инструменты, позволяя строить на основе существующей настройки без дублирования конфигурации.

Справка

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