grid-cards
A square in a grid says what it is in a tooltip, and gets a hover card only where it offers more than one thing to do. Applies whenever adding a square to an item or candy tray, or giving one of those
SKILL.md.claude/skills/grid-cards/SKILL.md
GitHubOne action is a tooltip. Two is a hover card.
A square in a tray is a picture. What it is has to be readable without
pressing anything, and a hover card is a window that covers the tray being read
from, so a square says its name and its line in a TooltipHost.
A card earns its place only when the square offers a choice. One thing to do is the square's own press and needs no buttons; two have to be pressed separately, and a tooltip cannot hold a button because it goes the moment the pointer leaves the trigger.
How a tray says which it wants
ItemGrid counts, so a caller never picks. An ItemCell lists what it offers in
actions:
{
item: auction.item,
actions: [
{ label: describeSeller(auction), onPress: () => game.setVisiting(auction.seller) },
{ label: 'Bid', tone: 'primary', onPress: () => setBidding(id) },
],
}
- No actions: a tooltip, and the tray's own
onPressruns the square. - One action: a tooltip, and pressing the square does that action.
- Two or more: a hover card, with the actions drawn as buttons in its foot.
A cell that lists actions has said what its square does, so the tray's
onPress and cardOnly no longer reach it.
What this means for the card body
Anything pressable inside a card body is an action and has to be counted, or it becomes unreachable the day the square drops to one action and turns into a tooltip. The auction board's seller name used to be an inline link in the card; it is an action now, which is what keeps that card a card.
Where it does not apply
The pokemon box is not covered. A catch square carries a record rather than a name, and its card is the record.