typescript-best-practices

Umiejętność dostarcza idiomatyczne wzorce TypeScript dla czytelnego i łatwego w utrzymaniu kodu. Obejmuje konwencje nazewnictwa (PascalCase dla klas, camelCase dla zmiennych), organizację modułów z named exports, async/await zamiast raw Promise, jawne modyfikatory dostępu w klasach oraz rygorystyczne typowanie bez any. Zawiera również anty-wzorce do unikania: default exports, niejawne zwroty, require zamiast import, puste interfejsy i eslint-disable komentarze. Idealna dla zespołów chcących utrzymać spójny, bezpieczny kod TypeScript.

1. Aktywuj umiejętność w swoim agencie AI, wskazując pliki TypeScript (*.ts, *.tsx) lub słowa kluczowe takie jak class, function, async, import, export.

2. Gdy agent analizuje lub refaktoryzuje kod TypeScript, umiejętność automatycznie sugeruje poprawki: zmień nazwy zmiennych na camelCase, klasy na PascalCase, stałe na UPPER_SNAKE.

3. Dla funkcji eksportowanych zawsze dodaj jawny typ zwracanej wartości; dla callbacków preferuj arrow functions zamiast regular functions.

4. Organizuj importy w kolejności: najpierw pakiety zewnętrzne, potem moduły wewnętrzne, na końcu ścieżki relatywne. Używaj import type dla typów, aby umożliwić tree-shaking.

5. W logice asynchronicznej zastosuj async/await zamiast raw Promise; dla operacji równoległych użyj Promise.all(). Nigdy nie używaj any — wymuszaj strict typing lub rzutuj unknown na konkretny typ.

6. W klasach dodaj jawne modyfikatory dostępu (public, private, protected), preferuj composition zamiast dziedziczenia, oznaczaj pola jako readonly gdzie to możliwe. Zabrania się eslint-disable i ts-ignore komentarzy — napraw problem u źródła.