import { LitElement } from 'lit';
import { ButtonVariant, ButtonType } from '@uswds-wc/core';
/**
 * USA Button Web Component
 *
 * A simple, accessible USWDS button implementation using a native button element.
 * Follows USWDS specifications exactly with a proper <button> element inside the web component.
 * This ensures full form integration and native button behavior.
 *
 * @element usa-button
 *
 * @slot - Default slot for button label/content
 *
 * @attr {string} variant - Button style variant: 'primary' | 'secondary' | 'accent-cool' | 'accent-warm' | 'base' | 'outline' | 'outline-inverse' | 'unstyled'. Defaults to 'primary'.
 * @attr {string} size - Button size: 'small' | 'medium' | 'big'. Defaults to 'medium'.
 * @attr {boolean} disabled - Whether the button is disabled. Defaults to false.
 * @attr {string} type - Button type: 'button' | 'submit' | 'reset'. Defaults to 'button'.
 * @attr {string} aria-label - Accessible label for the button.
 * @attr {string} aria-pressed - Toggle state for toggle buttons.
 *
 * @fires click - Dispatched when the button is clicked
 *
 * @example
 * ```html
 * <!-- Primary button -->
 * <usa-button>Primary Button</usa-button>
 *
 * <!-- Secondary button -->
 * <usa-button variant="secondary">Secondary</usa-button>
 *
 * <!-- Big outline button -->
 * <usa-button variant="outline" size="big">Large Outline</usa-button>
 *
 * <!-- Disabled button -->
 * <usa-button disabled>Disabled</usa-button>
 *
 * <!-- Submit button in a form -->
 * <usa-button type="submit">Submit Form</usa-button>
 * ```
 *
 * @see README.mdx - Complete API documentation, usage examples, and implementation notes
 * @see CHANGELOG.mdx - Component version history and breaking changes
 * @see TESTING.mdx - Testing documentation and coverage reports
 *
 * @uswds-js-reference https://github.com/uswds/uswds/tree/develop/packages/usa-button/src/index.js
 * @uswds-css-reference https://github.com/uswds/uswds/tree/develop/packages/usa-button/src/styles/_usa-button.scss
 * @uswds-docs https://designsystem.digital.gov/components/button/
 * @uswds-guidance https://designsystem.digital.gov/components/button/#guidance
 * @uswds-accessibility https://designsystem.digital.gov/components/button/#accessibility
 */
export declare class USAButton extends LitElement {
    static styles: import('lit').CSSResult;
    variant: ButtonVariant;
    size: 'small' | 'medium' | 'big';
    disabled: boolean;
    type: ButtonType;
    ariaLabel: string;
    ariaPressed: string | null;
    text: string;
    private buttonElement?;
    private originalContent;
    private usingUSWDSEnhancement;
    protected createRenderRoot(): HTMLElement;
    connectedCallback(): void;
    firstUpdated(): void;
    updated(changedProperties: Map<string, any>): void;
    private updateButtonElement;
    private initializeUSWDSButton;
    /**
     * Handle keyboard events to forward Enter/Space to the internal button
     * This ensures the button works correctly when focus is on the web component host
     */
    private handleKeyDown;
    disconnectedCallback(): void;
    /**
     * Clean up USWDS module on component destruction
     */
    private cleanupUSWDS;
    focus(options?: FocusOptions): void;
    click(): void;
    render(): import('lit-html').TemplateResult<1>;
}
//# sourceMappingURL=usa-button.d.ts.map