import { USWDSBaseComponent } from '@uswds-wc/core';
export interface ComboBoxOption {
    value: string;
    label: string;
    text?: string;
    disabled?: boolean;
}
export interface ComboBoxChangeDetail {
    value: string;
    displayValue: string;
}
/**
 * USA Combo Box Web Component
 *
 * Minimal wrapper around USWDS combo box functionality.
 * All option filtering, dropdown behavior, and interaction is managed by USWDS JavaScript.
 * USWDS transforms the simple select element into a full combo box with input and dropdown.
 *
 * @element usa-combo-box
 * @fires combo-box-change - Dispatched when selection changes (via USWDS)
 *
 * @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-combo-box/src/index.js
 * @uswds-css-reference https://github.com/uswds/uswds/tree/develop/packages/usa-combo-box/src/styles/_usa-combo-box.scss
 * @uswds-docs https://designsystem.digital.gov/components/combo-box/
 * @uswds-guidance https://designsystem.digital.gov/components/combo-box/#guidance
 * @uswds-accessibility https://designsystem.digital.gov/components/combo-box/#accessibility
 */
export declare class USAComboBox extends USWDSBaseComponent {
    static styles: import('lit').CSSResult;
    value: string;
    name: string;
    inputId: string;
    selectId: string;
    label: string;
    hint: string;
    placeholder: string;
    disabled: boolean;
    required: boolean;
    error: string;
    errorState: boolean;
    options: ComboBoxOption[];
    disableFiltering: boolean;
    private cleanup?;
    connectedCallback(): void;
    firstUpdated(changedProperties: Map<string, any>): Promise<void>;
    updated(changedProperties: Map<string, any>): void;
    disconnectedCallback(): void;
    private renderError;
    private renderRequiredIndicator;
    private renderHint;
    private renderLabel;
    private renderPlaceholderOption;
    private renderSelectOption;
    render(): import('lit-html').TemplateResult<1>;
    show(): void;
    hide(): void;
    updateOptions(): void;
}
//# sourceMappingURL=usa-combo-box.d.ts.map