Core

Barvy

Jeden resolver, kterým prochází každý barevný povrch — slovník, fallbacky a proč se odznak a tlačítko shodnou.

Barva je v tomhle frameworku sémantický název — success, danger, název z Tailwind palety — který na utility třídy překládá jeden vlastník. Ptá se ho odznak, tlačítko, toast i položka grafu, a proto se nemůžou rozejít — a taky proto dostane nový povrch celou paletu zadarmo.

Barvy

->color() přijímá kompletní Tailwind paletu na každém povrchu. Dva slovníky resolvují přes stejnou kanonickou mapu:

Sémantické role — pevné brand odstíny nesoucí význam:

Surové rodiny odstínů — každá Tailwind barva, pro jemnější kontrolu:

blue, green, red, yellow, cyan, slate, zinc, neutral, stone, orange, lime, teal, sky, indigo, violet, purple, fuchsia, pink, rose.

Literal odstíny nejsou aliasy. blue, green a yellow jsou vlastní literal Tailwind odstíny — blue je odlišný od přebarvitelného brand primary, green od success/emerald a yellow od warning/amber. red a cyan vykreslí stejný odstín jako danger/info, ale zůstávají dostupné pod svým jménem.

Achromatické krajní body — white a black. Tailwind nemá číselnou škálu white/black, takže se resolvují adaptivně: black je tmavá výplň/inkoust ve světlém režimu a překlopí se na bílou v tmavém, white je opačně — takže zůstanou čitelné v obou motivech.

Action::make('delete')->color('danger');   // sémantická role
Action::make('archive')->color('teal');     // surový odstín
BadgeColumn::make('status')->colors([
    'active' => 'success',
    'pending' => 'warning',
    'inactive' => 'danger',
]);

Type-safe enum Foundation\Colors\Color má case pro každou z těchto (Color::Danger, Color::Teal, …). Každá barva resolvuje na Tailwind utility třídy pro bg, text, border, ring a hover varianty — stejná hodnota se vykreslí identicky na badge, solid/outlined/link tlačítku, modalu, choice kartě a chart baru.

Kanonické color resolvery (HasColor)

Foundation\Concerns\HasColor jsou dveře, kterými se ptá každý povrch. Ptejte se jich místo re-enkódování match mapy a barva se vyřeší všude stejně.

Samotná pravidla bydlí v pěti třídách pod Foundation\Colors, jedna na povrch — ButtonPalette, TintPalette, TextPalette, NoticePalette a ChartPalette — protože rozhodnutí o alertu je jiné rozhodnutí než rozhodnutí o grafu. Volejte dál HasColor: palety jsou místo, kde se pravidlo najde a změní, ne druhá sada jmen k volání.

Role není odstín. success, danger, warning a info se vykreslí jako to, na co je nasměruje wire-core.colors, vyřešeno jednou v Foundation\Colors\SemanticPalette na začátku každého resolveru — viz Vzhled → Sémantické role. Literal odstíny zůstávají první třídy: green je literální zelená, odlišná od přesměrovatelného success, a adaptivní krajní body white/black resolvují samy na sebe.

Při přidávání barvy nebo povrchu rozšiřte jednou paletu, která ji vlastní — navazující sloupce, badge, akce a toggly ho vyzvednou automaticky. Udržujte utility názvy kompatibilní s nejnižší podporovanou verzí Tailwindu (viz ADR 0005); používejte jen standardní názvy odstínů, nikdy verzí-specifické.

Kanonické resolvery velikosti a typografie

Sourozenecké single-source resolvery, používané stejně jako HasColor — rozšiřte jednou, každý povrch je vyzvedne a řetězce tříd zůstanou literální pro Tailwind JIT scanner.

Type-safe hodnotové enumy

Každý fluent setter, který bere řetězcový token, přijímá také kanonický enum z Foundation\Enums\ — ->size('lg') a ->size(Size::Lg) jsou zaměnitelné a řetězcová forma zůstává plně podporovaná. Každý enum je jediný vlastník svého slovníku (values() + resolve()), takže token resolvuje na stejnou utility na každém povrchu a neznámé tokeny spadnou na rozumný výchozí místo emitování nescannovatelné třídy.

use NyonCode\WireCore\Foundation\Enums\{Alignment, Breakpoint, ModalWidth, Size};
 
TextColumn::make('email')->visibleFrom(Breakpoint::Md)->alignment(Alignment::Right);
Action::make('edit')->size(Size::Lg)->modalWidth(ModalWidth::TwoXl);

Enumy Breakpoint, Alignment a Placement navíc vlastní literální Tailwind třídy, na které jejich tokeny mapují (Breakpoint::Md->tableCellClass(), Alignment::Right->textClass(), Placement::TopEnd->originClass()), takže mapa tříd má jednoho vlastníka a Blade konzumuje scannovatelnou utility místo interpolace text-{$align}.

Související

• Ikony — druhá polovina slovníku povrchu
• Enumy — enum, který si pojmenuje vlastní barvu
• Motivy a přizpůsobení — změna palety, kterou aplikace používá
• BadgeColumn — rozhodovací žebříček na skutečném povrchu