import { LitElement, PropertyValues } from "lit";
import "../icon/icon.js";
import "../tooltip/tooltip.js";
export interface ComboboxOption {
    value: string;
    label?: string;
    key?: string;
}
declare const WarpCombobox_base: import("@open-wc/form-control").Constructor<import("@open-wc/form-control").FormControlInterface> & typeof LitElement;
/**
 * A combobox element for text input with selectable options.
 *
 * [Warp component reference](https://warp-ds.github.io/docs/components/combo-box/frameworks/elements)
 */
export declare class WarpCombobox extends WarpCombobox_base {
    #private;
    /**
     * The available options to select from.
     *
     * Use this for framework usage, application state, or remote search results. When `options` contains entries, it is used instead of child `<option>` elements.
     */
    options: ComboboxOption[];
    /**
     * The label displayed above the input.
     *
     * Use this to give the combobox a visible and accessible name.
     */
    label?: string;
    /**
     * Supplementary information that should show in a tooltip behind an information icon after the label.
     *
     * You must provide a label to be able to show an info icon with a tooltip.
     */
    tooltip?: string;
    /**
     * Placeholder text displayed when the input is empty.
     *
     * Use this as a short hint for the expected input. Do not use placeholder text as a replacement for a label.
     */
    placeholder?: string;
    /**
     * The selected or typed value.
     *
     * When an option is selected, this is set to the option value. The displayed text may differ when the option has a separate label.
     */
    value: string;
    /**
     * Whether the option list opens when the input receives focus.
     *
     * Use this when users should see available options before they start typing.
     */
    openOnFocus: boolean;
    /**
     * Whether the active option is selected when the input loses focus.
     *
     * When enabled, the combobox selects the keyboard-highlighted option, or an option whose value exactly matches the current input value, on blur.
     */
    selectOnBlur: boolean;
    /**
     * Whether matching text segments in options are highlighted.
     *
     * Use this to visually emphasize the part of each option that matches the current input value.
     */
    matchTextSegments: boolean;
    /**
     * Whether built-in client-side filtering is disabled.
     *
     * Use this for remote search or externally filtered results. When disabled, all entries in `options` are rendered as provided.
     */
    disableStaticFiltering: boolean;
    /**
     * Whether the combobox is visually invalid.
     *
     * Use this to show an externally managed validation error. Pair it with `help-text` to explain how to fix the error.
     */
    invalid: boolean;
    /**
     * Help text displayed below the input.
     *
     * Use this for supporting guidance or validation feedback.
     */
    helpText?: string;
    /**
     * Whether the combobox is disabled.
     *
     * Disabled comboboxes cannot be focused, changed, or submitted with form data.
     */
    disabled: boolean;
    /**
     * Whether the combobox is required before form submission.
     *
     * Use this when the user must provide a value before submitting the form.
     */
    required: boolean;
    /**
     * Whether to show optional text next to the label.
     *
     * Use this to indicate that the combobox is not required.
     */
    optional: boolean;
    /**
     * The name submitted with the combobox value.
     *
     * Use this when the combobox belongs to a form and its value should be included in form data.
     */
    name?: string;
    /**
     * The autocomplete attribute passed to the internal input.
     *
     * Defaults to `off`. Set this when browser autocomplete should be enabled or scoped to a specific autocomplete token.
     */
    autocomplete?: string;
    /** @internal Options list open boolean */
    private _isOpen;
    /** @internal The option the user has navigated to with their keyboard */
    private _navigationOption;
    /** @internal Available options based on user's input value */
    private _currentOptions;
    /** @internal Options parsed from light-DOM <option> children */
    private _lightDomOptions;
    /** @internal Unique identifier counter for options */
    private _optionIdCounter;
    /** @internal The text displayed in the input field (may differ from value when option has label) */
    private _displayValue;
    static styles: import("lit").CSSResult[];
    constructor();
    firstUpdated(): void;
    updated(changedProperties: Map<string, unknown>): void;
    resetFormControl(): void;
    connectedCallback(): void;
    disconnectedCallback(): void;
    private get _listboxId();
    private get _id();
    private get _helpId();
    private get _sourceOptions();
    /** Get the display text for the navigation option or current display value */
    private get _navigationLabelOrDisplayValue();
    /** Get the actual value for the navigation option or current value */
    private get _navigationValueOrInputValue();
    /** Generate options with unique IDs and match information */
    private _createOptionsWithIdAndMatch;
    /** Get ARIA text for screen readers */
    private _getAriaText;
    /** Get option classes */
    private _getOptionClasses;
    /** Handle keyboard navigation */
    private _handleKeyDown;
    /** Find and set active option based on keyboard navigation */
    private _findAndSetActiveOption;
    /** Handle option selection */
    private _handleSelect;
    /** Handle input change */
    private _handleChange;
    /** Handle input focus */
    private _handleFocus;
    /** Handle input blur */
    private _handleBlur;
    /** Handle option click */
    private _handleOptionClick;
    /** Handle container blur */
    private _handleContainerBlur;
    /** Render highlighted text match */
    private _renderTextMatch;
    protected willUpdate(changedProperties: PropertyValues<this>): void;
    render(): import("lit").TemplateResult<1>;
}
declare global {
    interface HTMLElementTagNameMap {
        "w-combobox": WarpCombobox;
    }
}
export {};