/**
 * createCountryInput - the HEADLESS core behind <SvCountryInput>: a searchable
 * country picker (search by name, dial code, or ISO code; roving active index +
 * keyboard) that emits the ISO 3166-1 alpha-2 code. Exposed as **prop-getters**
 * you spread onto YOUR OWN markup. No styles/DOM/portal - those stay in the
 * styled component.
 *
 * ```svelte
 * <script lang="ts">
 *   import { createCountryInput, flagEmoji } from '@svgrid/grid'
 *   let value = $state<string | null>(null)
 *   const ci = createCountryInput({ value: () => value, onChange: (c) => (value = c) })
 * </script>
 * <button {...ci.triggerProps()}>{ci.selected?.name ?? 'Select'}</button>
 * {#if ci.open}
 *   <input {...ci.searchProps()} />
 *   <ul {...ci.listboxProps()}>
 *     {#each ci.filtered as c, i (c.code)}<li {...ci.optionProps(i)}>{c.name}</li>{/each}
 *   </ul>
 * {/if}
 * ```
 */
import { type Country } from './countries';
/** Reactive inputs are passed as getters so the core tracks live prop changes. */
export type CountryInputConfig = {
    value: () => string | null;
    onChange?: (code: string) => void;
    disabled?: () => boolean;
    ariaLabel?: () => string | undefined;
    /** Accessible label for the in-panel search field (localizable). */
    searchLabel?: () => string | undefined;
    /** DOM focus hook provided by the renderer; the core never touches the DOM. */
    focusTrigger?: () => void;
    id?: () => string | undefined;
    invalid?: () => boolean;
    required?: () => boolean;
    error?: () => string | undefined;
    hint?: () => string | undefined;
};
export declare function createCountryInput(config: CountryInputConfig): {
    /** Panel open state. */
    readonly open: boolean;
    /** Highlighted country index into `filtered`. */
    readonly activeIndex: number;
    /** Current search query. */
    readonly query: string;
    /** Countries after the current search filter. */
    readonly filtered: Country[];
    /** The selected country, if any. */
    readonly selected: Country | null;
    /** Controlled value (ISO alpha-2 code). */
    readonly value: string | null;
    isActive: (i: number) => boolean;
    isSelected: (code: string) => boolean;
    setActive: (i: number) => void;
    setQuery: (v: string) => void;
    openPanel: () => void;
    close: () => void;
    toggle: () => void;
    pick: (code: string) => void;
    onKeydown: (e: KeyboardEvent) => void;
    /** Spread onto the trigger <button>. */
    triggerProps: () => {
        disabled: boolean;
        onclick: () => void;
        'aria-invalid': "true" | undefined;
        'aria-required': "true" | undefined;
        'aria-describedby': string | undefined;
        'aria-label': string | undefined;
        id: string | undefined;
        type: "button";
        'aria-haspopup': "listbox";
        'aria-expanded': boolean;
        'aria-controls': string;
    };
    /** Spread onto the search <input> inside the panel. */
    searchProps: () => {
        type: "text";
        value: string;
        'aria-label': string;
        'aria-controls': string;
        'aria-activedescendant': string | undefined;
        oninput: (e: Event) => void;
        onkeydown: (e: KeyboardEvent) => void;
    };
    /** Spread onto the listbox container. */
    listboxProps: () => {
        id: string;
        role: "listbox";
    };
    /** Spread onto the country option at `index` (index into `filtered`). */
    optionProps: (index: number) => {
        id: string;
        role: "option";
        tabindex: number;
        'aria-selected': boolean;
        'data-idx': number;
        onclick: () => void;
        onpointermove: () => void;
    };
};
export type CountryInput = ReturnType<typeof createCountryInput>;