/**
 * @usevyre/react — Input + Field
 *
 * AI CONTEXT:
 * ┌─────────────────────────────────────────────────────────┐
 * │ Components: Field + Input + Textarea                    │
 * │ Import:     import { Field, Input, Textarea } from "@usevyre/react" │
 * │                                                         │
 * │ Field props (props-based, simplest):                    │
 * │   label    = string                                     │
 * │   hint     = string (helper text below input)           │
 * │   state    = "idle"|"error"|"success"|"warning"         │
 * │   required = boolean                                    │
 * │ Field composable parts (richer layouts):                │
 * │   FieldLabel · FieldDescription · FieldError ·          │
 * │   FieldGroup · FieldSet (props-based API still works)    │
 * │                                                         │
 * │ Input props:                                            │
 * │   size     = "sm"|"md"(default)|"lg"                    │
 * │   leftElement  = ReactNode (icon inside input, left)    │
 * │   rightElement = ReactNode (icon inside input, right)   │
 * │   + all native <input> props                            │
 * └─────────────────────────────────────────────────────────┘
 *
 * @example
 * // Basic field with validation
 * <Field label="Email" state="error" hint="Invalid email format">
 *   <Input type="email" placeholder="you@example.com" />
 * </Field>
 *
 * // Input with icon
 * <Field label="Search">
 *   <Input leftElement={<SearchIcon />} placeholder="Search..." />
 * </Field>
 */
import React from "react";
import type { FieldState, Size, BaseProps } from "../../types";
export interface FieldProps extends React.HTMLAttributes<HTMLDivElement>, BaseProps {
    label?: string;
    hint?: string;
    state?: FieldState;
    required?: boolean;
    htmlFor?: string;
}
export declare const Field: React.ForwardRefExoticComponent<FieldProps & React.RefAttributes<HTMLDivElement>>;
export interface FieldLabelProps extends React.LabelHTMLAttributes<HTMLLabelElement>, BaseProps {
    required?: boolean;
}
export declare const FieldLabel: React.ForwardRefExoticComponent<FieldLabelProps & React.RefAttributes<HTMLLabelElement>>;
export interface FieldDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement>, BaseProps {
}
export declare const FieldDescription: React.ForwardRefExoticComponent<FieldDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
export interface FieldErrorProps extends React.HTMLAttributes<HTMLParagraphElement>, BaseProps {
}
export declare const FieldError: React.ForwardRefExoticComponent<FieldErrorProps & React.RefAttributes<HTMLParagraphElement>>;
export interface FieldGroupProps extends React.HTMLAttributes<HTMLDivElement>, BaseProps {
    orientation?: "vertical" | "horizontal";
}
export declare const FieldGroup: React.ForwardRefExoticComponent<FieldGroupProps & React.RefAttributes<HTMLDivElement>>;
export interface FieldSetProps extends React.FieldsetHTMLAttributes<HTMLFieldSetElement>, BaseProps {
    legend?: string;
}
export declare const FieldSet: React.ForwardRefExoticComponent<FieldSetProps & React.RefAttributes<HTMLFieldSetElement>>;
export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size">, BaseProps {
    size?: Exclude<Size, "icon">;
    leftElement?: React.ReactNode;
    rightElement?: React.ReactNode;
}
export declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
export interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement>, BaseProps {
    size?: Exclude<Size, "icon">;
    resize?: "none" | "vertical" | "horizontal" | "both";
}
export declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;