import "./text_input.css";
import type * as React from "react";
import { useRender } from "@base-ui/react/use-render";
import type { Commit } from "./commit_mode";
import { type IconName } from "./icon";
import { type StyleProps } from "./style_props";
import type { ShortcutDescriptor } from "./keyboard";
/** The element `inputRef` resolves to — a `<textarea>` once the field is multiline. */
export type TextInputElement = HTMLInputElement | HTMLTextAreaElement;
export interface TextInputBase extends StyleProps {
    placeholder?: string;
    /** Fired when Enter finishes a single-line field — see {@link commitsOnEnter}. */
    onSubmitEditing?: () => void;
    onKeyDown?: (event: React.KeyboardEvent<TextInputElement>) => void;
    onFocus?: (event: React.FocusEvent<TextInputElement>) => void;
    onBlur?: (event: React.FocusEvent<TextInputElement>) => void;
    autoFocus?: boolean;
    disabled?: boolean;
    /** Readable and focusable, but not typable — a value the page owns. */
    readOnly?: boolean;
    icon?: IconName;
    /** THE READER MAY EMPTY THIS FIELD: the ✕ commits the empty string. */
    clearable?: boolean;
    /** Grow vertically to fit the content, with `numberOfLines` as the floor. */
    autoGrow?: boolean;
    multiline?: boolean;
    /** Above 1 the field is multiline, reserves that many lines, and Enter inserts
     *  a newline instead of finishing the value. */
    numberOfLines?: number;
    maxLength?: number;
    /**
     * `password` masks and the rest steer the mobile keyboard and autofill —
     * except `search`, which is also the PRESET a toolbar or filter band reaches
     * for: the leading glyph, the clear ✕, Escape to let go of the field, and the
     * browser's own suggestion list suppressed. Each of the four is a DEFAULT —
     * pass `icon`, `clearable` or `autoComplete` to override one.
     */
    type?: "text" | "password" | "email" | "url" | "tel" | "search";
    inputMode?: React.HTMLAttributes<TextInputElement>["inputMode"];
    autoComplete?: string;
    autoCapitalize?: "none" | "sentences" | "words" | "characters";
    autoCorrect?: boolean;
    spellCheck?: boolean;
    name?: string;
    /** Overrides the id the enclosing `FormField` hands down. */
    id?: string;
    /** Keyboard shortcut badge shown in the right slot when the input is empty. */
    shortcut?: string | ShortcutDescriptor;
    clearLabel?: string;
    /** The value is CODE — a template, a workflow source, a field key — so it takes
     *  the mono family. The SIZE stays the input rung, which keeps the field on the
     *  band and stops iOS zooming a focused one. */
    font?: "mono";
    /**
     * HOW THE VALUE READS, for a field that is the record's own value rather than
     * a box to type in: `struck` is a completed item, `link` an address. Both are
     * ink and decoration off the ladder, and both stand down on an EMPTY field.
     *
     * `link` is a TREATMENT, never a swapped-in `TextLink`: pressing the field
     * still edits, and to OPEN the destination pass an `InlineButton` through
     * `actions`.
     */
    reading?: "struck" | "link";
    accessibilityLabel?: string;
    testID?: string;
    role?: React.AriaRole;
    "aria-expanded"?: boolean;
    "aria-controls"?: string;
    "aria-activedescendant"?: string;
    "aria-autocomplete"?: "none" | "inline" | "list" | "both";
    /** The text element itself — what a caller focuses, blurs or selects in. */
    inputRef?: React.Ref<TextInputElement>;
    ref?: React.Ref<HTMLElement>;
    render?: useRender.RenderProp;
}
/**
 * The standard text field, in the kit's two commit modes: a FORM holds the value
 * and commits in its footer (`onValueChange`), or the FIELD holds the draft and
 * writes it itself (`onSave`) — see `commit_mode.ts`.
 *
 * `className` / `style` / `ref` address the field's outer BOX; `inputRef`
 * reaches the text element.
 */
export type TextInputProps = TextInputBase & Commit<string>;
export declare function TextInput(props: TextInputProps): React.JSX.Element;