Checkbox

A checkbox with a label — a filter, a consent, a behaviour toggle. The label is part of the primitive: clicking the text toggles, and the accessible name comes for free.

When to use it

A yes/no filter above a list — “needs attention only”, “including sandboxes”. Next to selects in IngotToolbar.
Independent choices where several may hold at once. A row of checkboxes is a set; a select is exactly one.
A consent or confirmation in a form — the state takes effect when the form is submitted.

When not to use it

A toggle with immediate effect (“enable module”). That is a switch — it promises the thing already happened, and it will be its own primitive once a screen asks for it.
Picking exactly one variant. That is IngotSelect or IngotOptionCard, not a group of checkboxes unchecking each other.
Bulk row selection in a table — IngotTable draws that itself and owns the bulk bar.

Properties

checked: boolean — The current state. Controlled from outside.
onChange: (next: boolean) => void — The new state on every change.
label: ReactNode — The translated visible label. It carries the element's name and clicking it toggles — hence required.
disabled: boolean — A disabled choice — locked by the plan, say. Defaults to false.
className: string — A pass-through class on the wrapper.
testId: string — An anchor for tests — on the input, not the wrapper.