typescript

Skill zawierający praktyczne wytyczne do pisania TypeScript'u. Obejmuje zasady bezpieczeństwa typów, wzorce asynchroniczne, strukturę kodu i optymalizację wydajności. Aktywuje się automatycznie podczas pracy z plikami .ts, .tsx, .mts, omawiania bezpieczeństwa typów lub dyskusji o stylu kodu. Pomaga w recenzji jakości kodu i implementacji wzorców type-safe.

1. Aktywuj skill podczas pracy z kodem TypeScript. Skill automatycznie reaguje na pytania dotyczące TypeScript'u, bezpieczeństwa typów lub stylu kodu w plikach .ts, .tsx i .mts.

2. Przy definiowaniu typów stosuj wnioskowanie TypeScript'a — unikaj jawnych adnotacji, gdy kompilator potrafi sam określić typ. Zawsze unikaj niejawnego any; jeśli musisz być jawny, wybierz konkretny typ zamiast any.

3. Preferuj interface dla kształtów obiektów (np. props React'a) i type dla unii oraz przecięć typów. Dla stałych wartości używaj as const satisfies XyzInterface zamiast zwykłego as const.

4. W kodzie asynchronicznym wybieraj async/await zamiast callbacków lub łańcuchów .then(). Korzystaj z promise'owych wariantów API, np. import { readFile } from 'fs/promises', i Promise.all do operacji równoległych.

5. Strukturyzuj kod używając destrukturyzacji obiektów, opisowych nazw zmiennych i nazwanych stałych zamiast magicznych liczb. Deleguj formatowanie narzędziom dedykowanym do tego celu.

6. Optymalizuj wydajność: preferuj pętle for…of zamiast pętli indeksowych, ponownie używaj narzędzi z packages/utils lub zainstalowanych pakietów npm, oraz pobieraj tylko wymagane kolumny z bazy danych.