import { RefObject } from 'react';
import { DateTimePickerProps, UseDateTimePickerReturn } from './date-time-picker.types';
/**
 * Custom hook for the DateTimePicker component.
 *
 * This hook manages the interaction between the DateTimeInput, Calendar, and TimeSelectorPanel
 * components. It handles state synchronization, focus management, and event coordination
 * between the different parts of the date-time picker.
 *
 * ## Features
 *
 * - **Unified State Management**: Coordinates date and time state across components
 * - **Focus Management**: Handles focus trapping and keyboard navigation
 * - **Event Coordination**: Manages opening/closing and value updates
 * - **Input Integration**: Provides props for DateTimeInput component
 * - **Calendar Integration**: Manages calendar state and interactions
 * - **Time Integration**: Handles time selector state and changes
 *
 * @param props - DateTimePicker component props
 * @param ref - React ref to the container element
 * @returns Object with calendar state, input props, and time handling
 *
 * @example
 * ```tsx
 * const state = useDateTimePickerState(props);
 * const {
 *   calendarState,
 *   dateTimeInputProps,
 *   lockFocus,
 *   timeValue,
 *   onTimeChange
 * } = useDateTimePicker(props, state);
 * ```
 */
export declare const useDateTimePicker: (props: DateTimePickerProps, ref: RefObject<Element>) => UseDateTimePickerReturn;