theme | 'light' | 'dark' | 'dark' | Per-component theme override. |
size | 'sm' | 'md' | 'lg' | 'md' | Text and icon size tier. |
icon | string | 'arrow-right' | Lucide icon name (kebab-case), or "none" to hide icon. |
alignLabel | 'end' | 'start' | 'end' | Label position relative to icon. "end": [icon][label], "start": [label][icon]. |
underline | boolean | false | Adds underline decoration to the label text. |
active | boolean | false | Forces active visual state. Sets aria-current="page". |
hideLabel | boolean | false | Visually hides the label (icon-only mode). Always pair with label. |
stretch | boolean | false | Stretches component to fill container width. |
href | string | undefined | URL the link navigates to. Renders as <a> when set, <span> otherwise. |
target | '_self' | '_blank' | '_parent' | '_top' | '_self' | Where to open the linked URL. |
download | string | undefined | Triggers browser download dialog. |
rel | string | undefined | Relationship of the target. Defaults to noopener noreferrer when target="_blank". |
label | string | undefined | Accessible aria-label for icon-only usage. |