antfu

Skill zawierający opinionated setup Anthony'ego Fu dla projektów JavaScript i TypeScript. Obejmuje praktyki kodowania, organizację plików, konfigurację TypeScript, testowanie z Vitest oraz wybór narzędzi takich jak @antfu/ni. Użyj go przy tworzeniu nowych projektów, konfiguracji ESLint/Prettier alternatyw, zarządzaniu monorepo czy publikowaniu bibliotek. Idealny, gdy chcesz zastosować preferencje i standardy Anthony'ego Fu w swoim kodzie.

1. Zainstaluj narzędzie @antfu/ni, które upraszcza zarządzanie zależnościami niezależnie od menedżera pakietów (npm, yarn, pnpm). Uruchom ni, aby zainstalować zależności projektu, lub ni -D pakiet, aby dodać paczkę jako devDependency.

2. Organizuj kod zgodnie z zasadą single responsibility — każdy plik powinien mieć jasny, skoncentrowany cel. Gdy plik rośnie, podziel go na mniejsze moduły. Wydziel typy do pliku types.ts lub folderu types/*.ts, a stałe do constants.ts.

3. Pisz kod isomorphic, który działa w Node.js, przeglądarce i workers. Gdy kod jest specyficzny dla środowiska, oznacz to komentarzem na górze pliku: // @env node lub // @env browser.

4. W TypeScript zawsze deklaruj jawnie typy zwracane przez funkcje i wydzielaj złożone typy do dedykowanych deklaracji type lub interface zamiast definiować je inline.

5. Dodawaj komentarze, które wyjaśniają "dlaczego", a nie "jak" — kod powinien być samowyjaśniający się. Unikaj zbędnych komentarzy opisujących oczywiste operacje.

6. Testuj z Vitest — umieszczaj testy w tym samym katalogu co kod (foo.ts → foo.test.ts), używaj API describe/it, a dla złożonych wyników stosuj toMatchSnapshot lub toMatchFileSnapshot z jawną ścieżką.