tsdown
Bundler TypeScript dla bibliotek – szybka alternatywa dla tsup z obsługą ESM/CJS
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
tsdown to bundler TypeScript oparty na Rolldown i Oxc, stworzony do pakowania bibliotek do publikacji na npm. Generuje automatycznie deklaracje typów (.d.ts), obsługuje równoczesny output w formatach ESM i CommonJS, a także waliduje pakiet przed publikacją. Idealny do tworzenia komponentów Vue i React oraz każdej biblioteki TypeScript, którą chcesz udostępnić innym deweloperom. Działa jako drop-in zamiennik dla tsup.
Jak używać
Zainstaluj tsdown i TypeScript jako zależności deweloperskie: npm i -D tsdown typescript
Utwórz plik konfiguracyjny tsdown.config.ts w katalogu głównym projektu. Zdefiniuj punkt wejścia (entry), format wyjścia (np. 'esm'), włącz generowanie deklaracji typów (dts: true) i eksporty (exports: true) za pomocą funkcji defineConfig.
Uruchom bundler poleceniem tsdown w terminalu, aby zbudować bibliotekę. Pliki wyjściowe pojawią się w domyślnym katalogu output.
Aby pracować w trybie obserwacji zmian, użyj tsdown --watch – bundler będzie automatycznie przebudowywać bibliotekę po każdej edycji kodu źródłowego.
Jeśli potrzebujesz zaawansowanej konfiguracji (pluginy, shims, integracja z frameworkami), zapoznaj się z dokumentacją referencyjną w pliku advanced.md dołączonym do projektu.
Przed publikacją na npm sprawdź, czy plik package.json zawiera prawidłowe pola exports i types, wskazujące na wygenerowane pliki ESM, CJS i deklaracje typów.