import type { ButtonSize, ButtonType, ButtonVariant } from "./types";
import type { Theme } from "../../utils/styles";
/**
 * @component diwa-button
 *
 * A fully encapsulated, accessible button primitive.
 * Renders as a native <button> (or <a> when `href` is supplied).
 *
 * Design token override API (set on :root or any ancestor):
 *   --diwa-button-bg          Background color (primary variant default)
 *   --diwa-button-bg-hover    Hover background
 *   --diwa-button-color       Foreground / text color
 *   --diwa-button-radius      Border radius
 *   --diwa-button-height      Height for md size
 *   --diwa-button-height-xs   Height for xs size
 *   --diwa-button-height-sm   Height for sm size
 *   --diwa-button-height-lg   Height for lg size
 *   --diwa-button-padding-x   Horizontal padding for md/lg
 *   --diwa-button-padding-x-xs Horizontal padding for xs
 *   --diwa-button-padding-x-sm Horizontal padding for sm
 *
 * Usage:
 *   <diwa-button variant="primary">Get Started</diwa-button>
 *   <diwa-button variant="secondary" size="sm" disabled>Cancel</diwa-button>
 *   <diwa-button href="/dashboard" target="_blank">Open Panel</diwa-button>
 *
 * @slot default - Button label content (text, icons, or mixed)
 */
export declare class DiwaButton {
    host: HTMLDiwaButtonElement;
    /**
     * Per-component theme override.
     *
     * Setting this reflects data-theme onto the host element, causing the light/dark
     * token overrides in app.css to cascade into the Shadow DOM automatically.
     * Mirrors the `theme` prop on every PDS component.
     */
    theme: Theme;
    /** Visual style variant. */
    variant: ButtonVariant;
    /** Size tier - controls height and padding. */
    size: ButtonSize;
    /**
     * Native button type. Only applies when rendered as <button>
     * (i.e., no `href` prop is set).
     */
    type: ButtonType;
    /**
     * Disabled state. Blocks all pointer and keyboard interaction.
     * When rendered as <a>, sets aria-disabled instead of disabled
     * (the `disabled` attribute is not valid on anchor elements).
     */
    disabled: boolean;
    /**
     * Loading state. Shows an inline spinner, disables the button,
     * and sets aria-busy="true" to communicate async activity to
     * screen readers.
     */
    loading: boolean;
    /**
     * When set, the button renders as an <a> element (link semantics).
     * Pair with `target` for external links.
     */
    href?: string;
    /** Link target - only meaningful when `href` is set. */
    target?: "_blank" | "_self" | "_parent" | "_top";
    /** Native button name - submitted with form data. */
    name?: string;
    /** Native button value - submitted with form data. */
    value?: string;
    /**
     * Accessible label. Use when the visible slot content is not
     * descriptive enough (e.g., icon-only buttons).
     */
    label?: string;
    /**
     * When `true`, the default label slot is visually hidden so the button
     * renders as a compact square (icon-only mode). The slot text is kept in
     * the DOM for screen-reader accessible-name calculation.
     *
     * For best accessibility, always pair with the `label` prop **or** ensure
     * the default slot contains descriptive text, so the button has a name.
     *
     * Usage:
     *   <diwa-button hide-label label="Save">
     *     <svg slot="icon-start">...</svg>
     *   </diwa-button>
     */
    hideLabel: boolean;
    /**
     * Lucide icon name in kebab-case (e.g. `"star"`, `"arrow-right"`), or `'none'`
     * to show no icon. When set to any value other than `'none'`, renders a
     * `<diwa-icon>` in the leading (icon-start) position.
     *
     * The `icon-start` slot still works alongside this prop - the prop-rendered
     * icon comes first, followed by any slotted content.
     */
    icon: string;
    private get isInteractive();
    private get iconSize();
    private handleClick;
    render(): any;
}
//# sourceMappingURL=diwa-button.d.ts.map