import type { PrimitivePropsWithRef } from '../utils/primitive.js';
/**
 * Props for the {@link Textarea}, a wrapper around a native `<textarea>`, inheriting `name`, `required`, `rows`, and other native attributes directly.
 */
export interface TextareaProps extends PrimitivePropsWithRef<'textarea'> {
    /**
     * Current text content, for controlled usage; pair with `onChange`.
     * @default undefined — uncontrolled, seeded from `defaultValue`.
     */
    value?: string | undefined;
    /**
     * Initial text content for uncontrolled usage, read only on mount when `value` is unbound.
     * @default undefined — an empty textarea.
     */
    defaultValue?: string | undefined;
    /**
     * Native `maxlength` — longest value the control accepts, reported as `tooLong`.
     * @default undefined — no upper bound on the value's length.
     */
    maxLength?: number | undefined;
    /**
     * Native `minlength` — shortest value constraint validation accepts, reported as `tooShort`.
     * @default undefined — no lower bound on the value's length.
     */
    minLength?: number | undefined;
    /**
     * Grow the textarea to fit its content instead of showing a scrollbar.
     * @default false
     */
    autoResize?: boolean | undefined;
    /**
     * Caps auto-resize growth to this many rows, based on computed line-height.
     * @default undefined — grows without limit.
     */
    maxRows?: number | undefined;
    /**
     * The control's opening size and the floor `autoResize` will not shrink below, rendered as the native `rows` attribute when off.
     * @default 2 — the platform's own `rows` default, so an unmarked textarea is unchanged.
     */
    minRows?: number | undefined;
    /**
     * Marks the textarea as invalid, exposed as `aria-invalid`/`data-invalid`.
     * @default false
     */
    invalid?: boolean | undefined;
    /**
     * Makes the textarea read-only, exposed as the native `readOnly` attribute plus `aria-readonly`/`data-readonly`.
     * @default false
     */
    readOnly?: boolean | undefined;
    /**
     * Which axes the user may resize along, mirrored to `data-resize`.
     * @default undefined — the browser's own resize behaviour.
     */
    resize?: 'none' | 'block' | 'auto' | (string & {}) | undefined;
}