/**
 * @fileoverview `<ui-combobox>`: an input restricted to a predefined list.
 * @description Light-DOM custom element on the shared typeahead engine
 * (`base/typeahead.ts`). A relative of select: the panel filters as you type,
 * but free text can never submit. The form value lives in an authored hidden
 * input (`data-slot="combobox-value"`), synced whenever the selection changes.
 *
 * The visible input carries a **display value, not the filter**. Committing
 * writes the option label into it and clears the query, so reopening shows
 * the full list with the committed row checked, matching `.ui-select`.
 * Opening selects that label so the first keystroke replaces it, and focus
 * alone never opens the panel (a click, the chevron, an arrow key or typing
 * does). On blur, stray text reverts to the committed label and cleared text
 * clears the selection.
 *
 * `data-variant="multiselect"` selects a set instead: committing toggles a row
 * and keeps the panel open, and every selected value renders as a removable
 * tag stamped inside the control. The tag markup is HTML, not script: author
 * a `<template data-slot="combobox-tag-template">` to control its classes and
 * structure, and this file fills in the label, the value, and the remove
 * button accessible name. Without one, the ui-badge default below applies.
 * Backspace on an empty input drops the last tag. Options carrying
 * `aria-selected="true"` are the single source of truth: the tags and the
 * hidden inputs are both derived from them in DOM order so nothing can drift.
 * The form submits repeated `name` pairs like `<select multiple>`: the authored
 * hidden input carries the first value, and stamped siblings carry the rest.
 *
 * Where a no-JS fallback matters, prefer `.ui-select` / `<ui-multiselect>`:
 * this control is inert without its script (the hidden input still submits a
 * server-set value, but no tags render).
 *
 * Attributes on the root: `data-variant="multiselect"`, `data-sort="score"`,
 * `data-min-length="<n>"`, `data-label-remove="Remove {label}"`.
 * Parts: `combobox-value` (hidden input), `combobox-control` (select-look
 * shell), `combobox-tag-template` (authored `<template>`), `combobox-tag` /
 * `combobox-tag-label` / `combobox-tag-remove` (cloned from it),
 * `combobox-trigger` (chevron), `combobox-panel`, `combobox-list`,
 * `combobox-item`, `combobox-group` / `combobox-group-label`, `combobox-empty`.
 */
import { TypeaheadElement } from "../../base/typeahead.ts";
/** What a blur does to the input's text and to the committed selection. */
interface BlurOutcome {
    /** The text the input shows once focus has left. */
    value: string;
    /** Whether the committed selection is dropped. */
    clear: boolean;
}
/**
 * @description Resolves a blur: free text never survives it. The multiselect
 * variant always empties the filter (its selection lives in the tags), the
 * single variant restores the committed label, and an emptied single-select
 * input clears the selection outright.
 *
 * @param typed - The input's current text.
 * @param committedLabel - The last committed label, empty for no selection.
 * @param multiselect - Whether the multiselect variant is active.
 * @returns The text to show and whether to clear the selection.
 */
declare function resolveBlur(typed: string, committedLabel: string, multiselect: boolean): BlurOutcome;
/**
 * @description Fills the remove-button label template (`data-label-remove`).
 *
 * @param template - Template with a `{label}` placeholder.
 * @param label - The tag's visible label.
 * @returns The accessible name for that tag's remove button.
 */
declare function resolveRemoveLabel(template: string, label: string): string;
declare class UiCombobox extends TypeaheadElement {
    #private;
    protected readonly slotPrefix = "combobox";
    /** The input holds a committed label, so focus alone must not open the list. */
    protected readonly openOnFocus: boolean;
    protected setup(signal: AbortSignal): void;
    protected teardown(): void;
    /**
     * @description Combobox items match against what the user sees (the label)
     * not the machine `data-value`.
     *
     * @param item - The item element.
     * @returns The trimmed visible label.
     */
    protected itemValue(item: HTMLElement): string;
    /**
     * @description Escape with the panel already closed restores the committed
     * label (single) or drops the filter text (multiselect), avoiding a half-typed
     * value that a later blur would read as a cleared selection.
     */
    protected clearQuery(): void;
    /**
     * @description Committing shows the item's label, stores its `data-value` in
     * the hidden input, and moves `aria-selected`. The multiselect variant
     * toggles the row instead and keeps the panel open so picking can continue.
     *
     * @param item - The committed option.
     */
    protected commit(item: HTMLElement, _source: "keyboard" | "pointer"): void;
}
export { UiCombobox, resolveBlur, resolveRemoveLabel };
export type { BlurOutcome };
//# sourceMappingURL=combobox.d.ts.map