new-component

Umiejętność wspierająca tworzenie nowych komponentów interfejsu GPUI. Pomaga w budowaniu elementów UI, pisaniu komponentów bezstanowych i stanowych oraz komponowaniu złożonych interfejsów na bazie istniejących rozwiązań. Zawiera wytyczne dotyczące spójności stylów, dokumentacji i rejestracji komponentów w projekcie.

1. Określ typ komponentu, który chcesz utworzyć: bezstanowy (czysta prezentacja, jak Button), stanowy (zarządzający własnym stanem, jak Select) czy złożony (zbudowany na bazie istniejących komponentów, jak AlertDialog).

2. Utwórz nowy plik komponentu w katalogu crates/ui/src/ (np. alert_dialog.rs). Zdefiniuj strukturę komponentu z polami publicznymi i zaimplementuj konstruktor new() oraz metody buildera do konfiguracji właściwości.

3. Zarejestruj moduł komponentu w pliku crates/ui/src/lib.rs, dodając linię pub mod nazwa_komponentu;.

4. Upewnij się, że Twój komponent podąża za istniejącymi wzorcami z komponentów takich jak Button, Select czy Dialog — zachowaj spójność API i stylów zgodnie z wzorcem Shadcn UI.

5. Napisz dokumentację komponentu oraz story (scenariusze testowe) w dedykowanym folderze story.

6. Dodaj komponent do listy story w pliku crates/story/src/main.rs, aby był dostępny w systemie demonstracyjnym projektu.