import { FC, HTMLAttributes, Ref } from 'react';
import { PinFieldSize } from './types';
export interface PinFieldProps extends HTMLAttributes<HTMLDivElement> {
    /**
     * Disables the input field, making it non-interactive.
     * Also applies a visual disabled style.
     */
    disabled?: boolean;
    /**
     * Placeholder character shown when the field is empty.
     */
    placeholder?: string;
    /**
     * Visual size of the pin input.
     * Affects dimensions and font size.
     */
    size?: PinFieldSize;
    /**
     * Shows the field in an error state.
     */
    error?: boolean;
    /**
     * Ref forwarded to the native `<input>` element.
     * Useful for focus or programmatic control.
     */
    ref?: Ref<HTMLDivElement>;
    /**
     * Optional input mask that restricts characters for each digit.
     * Can be a RegExp or array of RegExp/string for per-character control.
     */
    mask?: Array<RegExp | string> | RegExp;
    /**
     * Max pin value
     */
    maxLength: number;
}
/** A PinField is a UI component that allows users to input OTP/Pin codes, commonly used for forms. */
export declare const PinField: FC<PinFieldProps>;