PageHint

A page hint with a bulb: a click highlights the elements the hint talks about, once.

When to use it

A screen where a new user is lost — the strip says in 2–3 sentences, in the second person, what to do here, and the bulb shows with what. title is the name of the screen or task, not “Help”.
Target elements carry data-hint-target and targets points at them with selectors. A bulb click gives them the is-hinted class for ~2.4 s — an accent-colored outline that fades away. It is a one-shot action, not a toggle.
Visibility is the caller's: visible is wired to the “Hints on pages” switch in the account menu and onDismiss stores the per-user, per-page dismissal on the account. The component does not decide on its own.

Confirming the result of an operation (“Saved”) — that is a toast, not a hint.
A warning or an error the user must react to — a hint is optional reading that can be switched off.
A multi-step walkthrough of a whole process — the strip describes one screen; a guided tour is a different pattern.

title: string — Name of the screen or task the strip talks about — not “Help”.
children: ReactNode — 2–3 sentences in the second person: what the user does here and with what.
targets: string[] — Selectors of the elements to highlight — typically [data-hint-target="…"]. Without targets the bulb is decoration only.
level: "simple" | "expert" | "both" — Whom the hint targets by the user's dictionary; both by default. Until dictionary modes exist, treat every user as both.
dismissible: boolean — Shows a close button. The dismissal is per user and page.
onDismiss: () => void — Close-button click. Persistence belongs on the user's account, not in localStorage.
visible: boolean — Controlled visibility — the “Hints on pages” switch in the account menu. false renders nothing.
bulbLabel: string — aria-label of the bulb. Defaults to the IngotProvider dictionary.
dismissLabel: string — aria-label of the close button. Defaults to the IngotProvider dictionary.
testId: string — data-testid of the strip; the bulb gets `${testId}-bulb`, the close button `${testId}-dismiss`.