/**
 * Custom hook to create a countdown timer to a target date.
 *
 * @param {Date} targetDate - The target date to count down to.
 * @param {string} [placeholder='- -'] - The placeholder value to display before the countdown starts.
 *
 * @returns {UseCountdownDateReturn} - An object containing the current countdown values in days, hours, minutes, and seconds.
 *
 * @example
 * const { days, hours, minutes, seconds } = useCountdownDate(new Date('2023-12-31T23:59:59'));
 *
 * return (
 *   <div>
 *     <p>Days: {days}</p>
 *     <p>Hours: {hours}</p>
 *     <p>Minutes: {minutes}</p>
 *     <p>Seconds: {seconds}</p>
 *   </div>
 * );
 */
type UseCountdownDateReturn = {
    days: string;
    hours: string;
    minutes: string;
    seconds: string;
};
declare function useCountdownDate(targetDate: Date, placeholder?: string): UseCountdownDateReturn;

export { type UseCountdownDateReturn, useCountdownDate };