/**
 * The options for the `useControlledState` hook.
 */
export interface UseControlledStateOptions<T = unknown, E = unknown> {
    /**
     * The value of the controlled state.
     */
    value?: T | undefined;
    /**
     * The default value of the uncontrolled state.
     */
    defaultValue?: T | undefined;
    /**
     * Callback function that is called when the value changes.
     */
    onChange?: (newValue: E) => void;
}
/**
 * The updater form accepted by the `useControlledState` setter.
 * Receives the current value and whether the state is controlled.
 */
export type UseControlledStateUpdater<T = unknown> = (prev: T | undefined, controlled: boolean) => unknown;
/**
 * The setter returned by the `useControlledState` hook.
 * Accepts either a resolved value or an updater function.
 */
export interface UseControlledStateSetter<T = unknown> {
    (updater: UseControlledStateUpdater<T>): void;
    (inValue: unknown): void;
}
/**
 * The return type of the `useControlledState` hook.
 * A tuple containing the current value and a function to update it.
 */
export type UseControlledStateReturnType<T = unknown> = [T | undefined, UseControlledStateSetter<T>, boolean];
/**
 * A custom hook that manages controlled and uncontrolled state.
 *
 * @param {UseControlledStateOptions} options - The options for the controlled state.
 * @returns A tuple containing the current value and a function to update it.
 *
 * @example
 * ```tsx
 * const ControlledComponent = () => {
 *    const [controlledValue, setControlledValue] = React.useState('');
 *
 *    const [value, setValue] = useControlledState({
 *        value: controlledValue,
 *        defaultValue: 'initial value',
 *        onChange: (newValue) => {
 *           setControlledValue(newValue);
 *        }
 *    });
 *
 *   return <Component value={value} onChange={(e) => setValue(e.target.value)} />;
 * };
 * ```
 */
export declare function useControlledState<T = unknown, E = T>({ value, defaultValue, onChange }: UseControlledStateOptions<T, E>): UseControlledStateReturnType<T | undefined>;