Elementy i kompozycja

Podstawa techniczna — ustalone

Decyzja Human 2026-09-19: prymitywy interakcji z Base UI są prywatną zależnością @polisoteka/design-ui. Szablony importują nasze komponenty, nie prymitywy biblioteki. Bez kopii kodu w aplikacjach i bez adapterów starego API.

• Tokeny określają wartości wyglądu; nie określają zachowania kontrolki.
• Base UI zapewnia mechanikę kontrolki; nie określa stylu marki.
• Nasza paczka ustala publiczne API, warianty, kompozycję i testy integracyjne.
• Szablon składa wspólne komponenty i treść właściwą dla danej ścieżki.

Prosty tekst, powierzchnia i odsyłacz pozostają semantycznym HTML. Nie dokładamy zależności od prymitywu, gdy nie ma mechaniki do obsłużenia. Shadcn/coss mogą być referencją projektową, ale ich rejestry, CLI i MCP nie są etapem budowania UI. Źródło kontraktu: spec-design-001 — źródło w repo: company/specs/design/design-system.md.

Brief do wykonania

@todo(elements): wykonać poniższy brief, przedstawić rezultat i dowody odbioru. Usunięcie znacznika nie jest wykonaniem zadania.

• Zakres: Wyodrębnij elementy tekstu, układu, powierzchni i focus potrzebne szablonom. Pokaż ich zależności i granicę odpowiedzialności wobec komponentów. Nie buduj katalogu na zapas.
• Konwencja: najpierw reguła lub gotowe zastosowanie, potem przykład i kontrprzykład, następnie granice oraz sposób sprawdzenia. Nie zastępuj materiału opisem planu jego przygotowania.
• Źródła: platforma marki; zaakceptowane decyzje warsztatów. Zastane demo lub deklaracja PoC nie zatwierdzają nowej reguły.
• Powiązania: Tokeny i zależności, Siatka i responsywność.
• Granica swobody: możesz redagować i pokazywać istniejące ustalenia. Nową obietnicę, wybór wizualny, dane firmy i twierdzenie produktowe przedstaw do decyzji; nie uzupełniaj z pamięci.

Weryfikacja

Sprawdź rzeczywisty render i użycie wspólnego kodu, desktop/mobile, jasny/ciemny tryb oraz właściwe konteksty portali. Bramka techniczna: pnpm design:check; przed wydaniem także pnpm design:audit. Sam opis ani zielony test innego demo nie jest dowodem odbioru tego elementu.