import type { JSX } from "@solidjs/web";
import { type Accessor } from "solid-js";
import { type Group } from "../combobox/internals/resolve-value-label.js";
import { type MaybeAccessor } from "../internals/maybe-accessor.js";
export type AutocompleteMode = "list" | "both" | "inline" | "none";
export type AutocompleteChangeReason = "item-press" | "input-change" | "escape-key" | "outside-press" | "imperative";
export interface CreateAutocompleteOptions<Value = unknown> {
    /**
     * Input value (the text in the autocomplete input). Consumer-owned signal.
     * Writes happen via `onValueChange` — the primitive does NOT keep an internal
     * copy.
     */
    value: MaybeAccessor<string | undefined>;
    onValueChange?: (value: string, reason: AutocompleteChangeReason) => void;
    /** Open state. Consumer-owned signal. */
    open: MaybeAccessor<boolean>;
    onOpenChange?: (open: boolean, reason: AutocompleteChangeReason) => void;
    /** Items to filter. Flat array or grouped (`{ items: [...] }`). */
    items?: MaybeAccessor<readonly Value[] | readonly Group<Value>[] | undefined>;
    /**
     * Filter function. Pass `null` to disable filtering. Defaults to an
     * `Intl.Collator`-backed "contains" filter.
     */
    filter?: MaybeAccessor<((item: Value, query: string, itemToStringLabel?: (item: Value) => string) => boolean) | null | undefined> | undefined;
    /** Locale for the default `Intl.Collator`. */
    locale?: MaybeAccessor<Intl.LocalesArgument | undefined>;
    /**
     * Filtering and inline-autocomplete mode.
     * @default "list"
     */
    mode?: MaybeAccessor<AutocompleteMode | undefined>;
    disabled?: MaybeAccessor<boolean | undefined>;
    readOnly?: MaybeAccessor<boolean | undefined>;
    /** Converts object items to a display string. */
    itemToStringLabel?: MaybeAccessor<((item: Value) => string) | undefined>;
    /** Custom item equality. Defaults to `Object.is`. */
    isItemEqualToValue?: MaybeAccessor<((item: Value, value: Value) => boolean) | undefined>;
}
export interface AutocompleteApi<Value = unknown> {
    /** Reactive accessor for the current input value. */
    value: Accessor<string>;
    /** Reactive accessor for the open state. */
    open: Accessor<boolean>;
    /** Current mode. */
    mode: Accessor<AutocompleteMode>;
    disabled: Accessor<boolean>;
    readOnly: Accessor<boolean>;
    /** All items (before filtering). */
    items: Accessor<readonly Value[] | readonly Group<Value>[] | undefined>;
    /** Items after applying the filter against the current query. */
    filteredItems: Accessor<readonly Value[] | readonly Group<Value>[]>;
    /** Flat version of `filteredItems` (groups are unwrapped). */
    flatFilteredItems: Accessor<readonly Value[]>;
    /** Trimmed query string used for filtering. */
    query: Accessor<string>;
    /** Whether the items list is grouped. */
    isGrouped: Accessor<boolean>;
    /** Label accessor for rendering item text. */
    itemLabel: (item: Value) => string;
    /** Pure event-emitter — fire `onValueChange`. Consumer owns the signal write. */
    setValue: (next: string, reason?: AutocompleteChangeReason) => void;
    /** Pure event-emitter — fire `onOpenChange`. */
    setOpen: (next: boolean, reason?: AutocompleteChangeReason) => void;
    /**
     * Context provider. Wrap a subtree to make the api discoverable via
     * `useAutocomplete()` without prop-drilling.
     */
    Provider: (props: {
        children: JSX.Element;
    }) => JSX.Element;
}
export declare function useAutocomplete<Value = unknown>(): AutocompleteApi<Value>;
/**
 * Solid 2-native headless primitive for autocomplete selection + filtering
 * logic. Autocomplete is the "input value is the source of truth" variant:
 * there is no separate selected-value state — the input text IS the value.
 * Owns: value / open state, items / filteredItems / query derivation, and
 * item label helpers. DOM concerns (floating-ui, input element, keyboard nav,
 * portal) live in the structural `<Autocomplete.Root>` wrapper.
 */
export declare function createAutocomplete<Value = unknown>(options: CreateAutocompleteOptions<Value>): AutocompleteApi<Value>;
//# sourceMappingURL=create-autocomplete.d.ts.map