Statement
Button components shall support Primary, Outline, Secondary, Secondary Outline, Tertiary, Tertiary Outline, Neutral, Inverted, On Primary, On Secondary, and On Tertiary visual variations. Outline variations represent hollow/ghost treatments reusing their matching action token family. Contextual on-* variants are designed for use on matching brand-colored surfaces. A documented semantic-token override escape hatch allows rare one-off treatments using semantic token references. Per-instance border-radius is controlled via Tailwind utility classes on class, not a dedicated prop.
Rationale
REQ-00052 establishes that buttons support defined variations without naming them. Formalising the eleven-variation set with contextual and escape-hatch support ensures consistent implementation across projects and prevents drift in child themes.
Topics
Owner: component-system
Related: design-tokens
Applies To
- Primitive Components DOC-00010