import { ElementType, ReactNode, Ref, FocusEvent, KeyboardEvent, FormEvent, ComponentPropsWithoutRef } from 'react';
import { Color } from '../types.js';
import { SurfaceCutOwnProps } from './SurfaceCut.js';
export type TextareaSize = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
interface TextareaOwnProps<C extends ElementType = 'div'> {
    /** Polymorphic wrapper element. Defaults to `'div'`. The editable area itself is always a `contenteditable` `<div>`. */
    as?: C;
    /** Forwarded to the `SurfaceCut` root element. */
    ref?: Ref<HTMLElement>;
    /** Controlled value. Synced into the editable `innerText` on change (see `updateContentOnChange`). */
    value?: string;
    /** Placeholder text shown when the editor is empty. */
    placeholder?: string;
    /** Maximum number of characters the user can type or paste. Enforced manually since the editor is a `contenteditable` element, not a native `<textarea>`. */
    maxLength?: number;
    /** Visually dim the textarea and remove `contenteditable`. */
    disabled?: boolean;
    /** Make the textarea non-editable but still selectable. */
    readOnly?: boolean;
    /** Apply pill-style corners. Default `false` - uses size-specific radii. */
    rounded?: boolean;
    /** Textarea size token. Drives min-height, padding, and font size. Default `'lg'`. */
    size?: TextareaSize;
    /** Fires on every input event. First arg is the new text, second is the raw event. */
    onChange?: (value: string, event?: FormEvent<HTMLDivElement>) => void;
    /** Forwarded to the editable area - fires on key down. */
    onKeyDown?: (e: KeyboardEvent<HTMLDivElement>) => void;
    /** Forwarded to the editable area - fires when it gains focus. */
    onFocus?: (e: FocusEvent<HTMLDivElement>) => void;
    /** Forwarded to the editable area - fires when it loses focus. */
    onBlur?: (e: FocusEvent<HTMLDivElement>) => void;
    /** Accent color token. Drives the focus ring and `infoMessage` colors. Default: theme accent. */
    color?: Color;
    /** Slot rendered before the editable area. */
    prefix?: ReactNode;
    /** Slot rendered after the editable area. */
    suffix?: ReactNode;
    /**
     * When `true` (default), syncs the editable `innerText` whenever `value` changes from the outside.
     *
     * Set to `false` for performance-sensitive editors that manage their own DOM (e.g. rich-text editors) - otherwise external `value` updates would stomp on caret position and selection.
     */
    updateContentOnChange?: boolean;
    /** Extra classes for the outer wrapper. */
    className?: string;
    /** Extra classes for the inner content row (where prefix/editor/suffix live). */
    contentClassName?: string;
    /** Extra classes for the editable `[contenteditable]` `<div>`. */
    inputClassName?: string;
    /** Extra classes for the placeholder layer. */
    placeholderClassName?: string;
    /** Validity state. Default `true`.
     *
     * When `false`, switches the focus ring to red and shows `errorMessage`. */
    valid?: boolean;
    /** Render the focus ring flush against the element (`inset-0`) instead of offset outside it (`-inset-1.5`). Use when the textarea sits at the edge of an `overflow` container, where the offset ring would add unwanted scroll overflow. Default `false`. */
    tightFocusRing?: boolean;
    /** Floating label shown above the editor on focus. Hidden when `valid === false` or `readOnly`. */
    infoMessage?: ReactNode;
    /** Floating error label. Always visible when `valid === false`. */
    errorMessage?: ReactNode;
    /** Icon node rendered absolutely positioned on the left. */
    icon?: ReactNode;
    /** Extra classes for the icon wrapper. */
    iconClassName?: string;
    /** Reserved - currently not applied in the rendered output. */
    inputPadding?: string;
}
export type TextareaProps<C extends ElementType = 'div'> = TextareaOwnProps<C> & Omit<SurfaceCutOwnProps<C>, keyof TextareaOwnProps<C> | 'children'> & Omit<ComponentPropsWithoutRef<C>, keyof TextareaOwnProps<C>>;
/** Shape of `Textarea` defaults that can be supplied via `CladdProvider`'s `defaults` prop. */
export type TextareaDefaultProps = Partial<Omit<TextareaOwnProps, 'as' | 'ref' | 'value' | 'onChange'>>;
export declare const Textarea: <C extends ElementType = "div">(props: TextareaProps<C>) => import("react/jsx-runtime").JSX.Element;
export {};
//# sourceMappingURL=Textarea.d.ts.map