PageHint

Nápověda stránky se žárovkou: klik jednorázově zvýrazní prvky, kterých se nápověda týká.

Kdy použít

Obrazovka, kde si nový uživatel neví rady — pruh v 2–3 větách v druhé osobě řekne, co tady udělá, a žárovka mu ukáže čím. title je název obrazovky nebo úkolu, ne „Nápověda“.
Cílové prvky nesou data-hint-target a targets na ně míří selektory. Klik na žárovku jim na ~2,4 s přidá třídu is-hinted — rámeček v barvě akcentu, který plynule zmizí. Je to jednorázová akce, ne přepínač.
Viditelnost řídí volající: visible je napojené na přepínač „Nápověda na stránkách“ v menu účtu a onDismiss ukládá skrytí pro daného uživatele a stránku na účet. Komponenta se sama nerozhoduje.

Potvrzení výsledku operace („Uloženo“) — to je toast, ne nápověda.
Varování nebo chyba, na kterou musí uživatel reagovat — nápověda je volitelné čtení, které jde vypnout.
Vícekrokové provedení celým procesem — pruh popisuje jednu obrazovku; průvodce je jiný vzor.

title: string — Název obrazovky nebo úkolu, o kterém pruh mluví — ne „Nápověda“.
children: ReactNode — 2–3 věty v druhé osobě: co tady uživatel udělá a čím.
targets: string[] — Selektory prvků k zvýraznění — typicky [data-hint-target="…"]. Bez cílů je žárovka jen dekorace.
level: "simple" | "expert" | "both" — Komu je nápověda určená podle slovníku uživatele; výchozí both. Dokud režimy slovníku nejsou, ber všechny uživatele jako both.
dismissible: boolean — Ukáže křížek. Skrytí platí pro daného uživatele a stránku.
onDismiss: () => void — Klik na křížek. Perzistence patří na účet uživatele, ne do localStorage.
visible: boolean — Řízená viditelnost — přepínač „Nápověda na stránkách“ v menu účtu. false nekreslí nic.
bulbLabel: string — aria-label žárovky. Výchozí ze slovníku IngotProvider.
dismissLabel: string — aria-label křížku. Výchozí ze slovníku IngotProvider.
testId: string — data-testid pruhu; žárovka dostane `${testId}-bulb`, křížek `${testId}-dismiss`.