import type { PolymorphicTag, PrimitivePropsWithRef } from '../utils/primitive.js';
/**
 * Props for the {@link Button} root, extending the native `<button>` attributes.
 */
export interface ButtonProps extends Omit<PrimitivePropsWithRef<'button'>, 'type'> {
    /**
     * Element name to render instead of `<button>`, taken from the library's tag allowlist.
     * @default 'button'
     */
    as?: PolymorphicTag | undefined;
    /**
     * Marks the button busy, setting `aria-busy` and `data-loading`/`data-disabled` while suppressing activation without removing native `disabled`.
     * @default false
     */
    loading?: boolean | undefined;
    /**
     * Describes what is in progress while `loading` is true, rendered as a visually-hidden node referenced by `aria-describedby`.
     * @default 'Loading'
     */
    loadingLabel?: string | undefined;
    /**
     * Native disabled state, set as the native `disabled` attribute; outranks `loading` when both are set.
     * @default false
     */
    disabled?: boolean | undefined;
    /**
     * Keeps a `disabled` button in the tab order, emitting `aria-disabled` and `tabindex="0"` instead of the native attribute.
     * @default false
     */
    focusableWhenDisabled?: boolean | undefined;
    /**
     * Native button type, defaulting to `'button'` so it never accidentally submits an enclosing form.
     * @default 'button'
     */
    type?: 'button' | 'submit' | 'reset' | undefined;
    /**
     * Renders the skin square icon-only button, mirrored as a bare `data-icon-only`.
     * @default undefined — a normal label-and-padding button.
     */
    iconOnly?: boolean | undefined;
    /**
     * Size rung the skin scales the button by, mirrored to `data-size`.
     * @default undefined — the skin's own default size.
     */
    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
    /**
     * Severity rung the skin colours the button by, mirrored to `data-status`.
     * @default undefined — the skin's own neutral styling.
     */
    status?: 'neutral' | 'brand' | 'info' | 'success' | 'warning' | 'danger' | (string & {}) | undefined;
    /**
     * Visual weight rung the skin gives the button, mirrored to `data-variant`.
     * @default undefined — the skin's own default weight.
     */
    variant?: 'secondary' | 'primary' | 'danger' | 'outline' | 'ghost' | (string & {}) | undefined;
}