/**
 * @usevyre/react — NumberInput
 *
 * AI CONTEXT:
 * ┌──────────────────────────────────────────────────────────────────┐
 * │ Component:  NumberInput                                           │
 * │ Import:     import { NumberInput } from "@usevyre/react"           │
 * │                                                                   │
 * │ Controlled numeric input with −/+ stepper buttons. onChange emits │
 * │ a NUMBER (or null when empty) — not an event. Drops straight into │
 * │ <FormField> (Form handles the non-event value automatically).     │
 * │                                                                   │
 * │   value     = number | null   (controlled)                        │
 * │   onChange  = (value: number | null) => void                      │
 * │   min max step = number   (step default 1)                        │
 * │   precision = number   (decimal places to round to)               │
 * │   size      = "sm" | "md"(default) | "lg"                         │
 * │   disabled readOnly = boolean                                     │
 * │                                                                   │
 * │ Clamps to min/max on blur. Keyboard: ArrowUp/Down ±step,          │
 * │ Shift+Arrow ±step×10. Empty input → null.                         │
 * └──────────────────────────────────────────────────────────────────┘
 *
 * @example
 * const [qty, setQty] = useState<number | null>(1);
 * <NumberInput value={qty} onChange={setQty} min={1} max={99} />
 *
 * @example
 * <FormField name="age" label="Age" rules={{ required: true, min: 18 }}>
 *   <NumberInput min={0} max={120} />
 * </FormField>
 */
import React from "react";
import type { Size, BaseProps } from "../../types";
export interface NumberInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "value" | "onChange" | "defaultValue" | "type">, BaseProps {
    /** Controlled value. null = empty. */
    value?: number | null;
    /** Uncontrolled initial value */
    defaultValue?: number | null;
    /** Called with the parsed number, or null when the field is empty */
    onChange?: (value: number | null) => void;
    min?: number;
    max?: number;
    /** Increment/decrement amount (default 1) */
    step?: number;
    /** Decimal places to round to */
    precision?: number;
    size?: Exclude<Size, "icon">;
    disabled?: boolean;
    readOnly?: boolean;
}
export declare const NumberInput: React.ForwardRefExoticComponent<NumberInputProps & React.RefAttributes<HTMLInputElement>>;