| variant | 'primary' | 'secondary' | 'danger' | 'outline' | 'ghost' | 'secondary' | Visual treatment. |
| accent | 'cyan' | 'emerald' | 'amber' | 'violet' | 'rose' | 'cyan' | Tint for primary, outline, and badge. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'md' | Control size. |
| disabled | boolean | false | Native disabled + reduced opacity. |
| pending | boolean | false | Disabled state with a spinner slot. |
| type | 'button' | 'submit' | 'reset' | 'button' | Native button type. |
| className | string | '' | Extra classes appended to the button. |
| ariaPressed | boolean | — | Toggle state for pressable buttons. |
| ariaExpanded | boolean | — | Disclosure state for popover triggers. |
| ariaLabel | string | — | Accessible name for icon-only buttons. |
| onClick | (event: MouseEvent) => void | — | Click handler. |
| onKeyDown | (event: KeyboardEvent) => void | — | Keydown handler. |
| preventFocusSteal | boolean | false | Keeps focus on the current element when clicked. |
| dataTip | string | — | data-tip attribute for the host tooltip engine. |
| tooltip | string | — | Wraps the button with the positioned Tooltip. |
| tooltipAlign | 'center' | 'left' | 'right' | 'center' | Tooltip alignment. |
| badge | string | number | — | Count pill overhanging the top-right corner. |
| icon | Snippet | — | Leading icon; icon-only when no children. |
| children | Snippet | — | Button label/content. |
| buttonEl | HTMLButtonElement | null | null | Bindable native button element. |