best-react-datepicker 0.2.0

package/dist/hooks.d.ts

@@ -0,0 +1,555 @@
+import { W as WeekDay, D as DateMatcher, d as DatePickerLocale, C as CalendarMonth, e as DateRange, R as RangePreset } from './types-DA2PcEiy.js';
+import * as react from 'react';
+
+interface UseCalendarOptions {
+    defaultMonth?: Date;
+    month?: Date;
+    onMonthChange?: (month: Date) => void;
+    numberOfMonths?: number;
+    weekStartsOn?: WeekDay;
+    fixedWeeks?: boolean;
+    minDate?: Date;
+    maxDate?: Date;
+    disabled?: DateMatcher | DateMatcher[];
+    highlighted?: DateMatcher | DateMatcher[];
+    showWeekNumbers?: boolean;
+    showOutsideDays?: boolean;
+    locale?: DatePickerLocale;
+}
+interface UseCalendarReturn {
+    months: CalendarMonth[];
+    focusedDate: Date | null;
+    viewingYear: number;
+    viewingMonth: number;
+    goToNextMonth: () => void;
+    goToPrevMonth: () => void;
+    goToNextYear: () => void;
+    goToPrevYear: () => void;
+    goToMonth: (month: number) => void;
+    goToYear: (year: number) => void;
+    goToDate: (date: Date) => void;
+    goToToday: () => void;
+    setFocusedDate: (date: Date | null) => void;
+    isDateDisabled: (date: Date) => boolean;
+    isDateHighlighted: (date: Date) => boolean;
+    isOutsideRange: (date: Date) => boolean;
+    locale: DatePickerLocale;
+}
+declare function useCalendar(options?: UseCalendarOptions): UseCalendarReturn;
+
+interface UseDatePickerOptions extends UseCalendarOptions {
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (date: Date | null) => void;
+    closeOnSelect?: boolean;
+    format?: string;
+    clearable?: boolean;
+    required?: boolean;
+    readOnly?: boolean;
+    placeholder?: string;
+    name?: string;
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function useDatePicker(options?: UseDatePickerOptions): {
+    selectedDate: Date | null;
+    selectDate: (date: Date) => void;
+    clearDate: () => void;
+    formattedValue: string;
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    isSelected: (date: Date) => boolean;
+    getInputProps: () => {
+        type: "text";
+        value: string;
+        placeholder: string;
+        readOnly: boolean;
+        'aria-label': string;
+        'aria-haspopup': "dialog";
+        'aria-expanded': boolean;
+        autoComplete: "off";
+        onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+        onFocus: () => void;
+        onBlur: () => void;
+        onClick: () => void;
+    };
+    getPopoverProps: () => {
+        role: "dialog";
+        'aria-modal': true;
+        'aria-label': string;
+    };
+    getHiddenInputProps: () => {
+        type: "hidden";
+        name: string | undefined;
+        value: string;
+    };
+    clearable: boolean;
+    required: boolean;
+    months: CalendarMonth[];
+    focusedDate: Date | null;
+    viewingYear: number;
+    viewingMonth: number;
+    goToNextMonth: () => void;
+    goToPrevMonth: () => void;
+    goToNextYear: () => void;
+    goToPrevYear: () => void;
+    goToMonth: (month: number) => void;
+    goToYear: (year: number) => void;
+    goToDate: (date: Date) => void;
+    goToToday: () => void;
+    setFocusedDate: (date: Date | null) => void;
+    isDateDisabled: (date: Date) => boolean;
+    isDateHighlighted: (date: Date) => boolean;
+    isOutsideRange: (date: Date) => boolean;
+    locale: DatePickerLocale;
+};
+type UseDatePickerReturn = ReturnType<typeof useDatePicker>;
+
+interface UseRangePickerOptions extends UseCalendarOptions {
+    value?: DateRange;
+    defaultValue?: DateRange;
+    onChange?: (range: DateRange) => void;
+    minDays?: number;
+    maxDays?: number;
+    presets?: RangePreset[];
+    allowSameDay?: boolean;
+    format?: string;
+    separator?: string;
+    startName?: string;
+    endName?: string;
+    startPlaceholder?: string;
+    endPlaceholder?: string;
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    closeOnSelect?: boolean;
+}
+declare function useRangePicker(options?: UseRangePickerOptions): {
+    range: DateRange;
+    hoveredDate: Date | null;
+    activeInput: "end" | "start";
+    handleDayClick: (date: Date) => void;
+    applyPreset: (preset: RangePreset) => void;
+    clearRange: () => void;
+    setHoveredDate: react.Dispatch<react.SetStateAction<Date | null>>;
+    isRangeStart: (date: Date) => boolean;
+    isRangeEnd: (date: Date) => boolean;
+    isInRange: (date: Date) => boolean;
+    isInPreviewRange: (date: Date) => boolean;
+    isSelected: (date: Date) => boolean;
+    formattedStart: string;
+    formattedEnd: string;
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    presets: RangePreset[];
+    separator: string;
+    activePresetIndex: number;
+    getStartInputProps: () => {
+        type: "text";
+        value: string;
+        placeholder: string;
+        readOnly: true;
+        'aria-label': string;
+        onClick: () => void;
+    };
+    getEndInputProps: () => {
+        type: "text";
+        value: string;
+        placeholder: string;
+        readOnly: true;
+        'aria-label': string;
+        onClick: () => void;
+    };
+    getPopoverProps: () => {
+        role: "dialog";
+        'aria-modal': true;
+        'aria-label': string;
+    };
+    getPresetButtonProps: (preset: RangePreset) => {
+        type: "button";
+        onClick: () => void;
+        'aria-label': string;
+    };
+    months: CalendarMonth[];
+    focusedDate: Date | null;
+    viewingYear: number;
+    viewingMonth: number;
+    goToNextMonth: () => void;
+    goToPrevMonth: () => void;
+    goToNextYear: () => void;
+    goToPrevYear: () => void;
+    goToMonth: (month: number) => void;
+    goToYear: (year: number) => void;
+    goToDate: (date: Date) => void;
+    goToToday: () => void;
+    setFocusedDate: (date: Date | null) => void;
+    isDateDisabled: (date: Date) => boolean;
+    isDateHighlighted: (date: Date) => boolean;
+    isOutsideRange: (date: Date) => boolean;
+    locale: DatePickerLocale;
+};
+type UseRangePickerReturn = ReturnType<typeof useRangePicker>;
+
+interface UseTimePickerOptions {
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (date: Date | null) => void;
+    format?: '12h' | '24h';
+    minuteStep?: number;
+    secondStep?: number;
+    showSeconds?: boolean;
+    minTime?: {
+        hours: number;
+        minutes: number;
+    };
+    maxTime?: {
+        hours: number;
+        minutes: number;
+    };
+    name?: string;
+    placeholder?: string;
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function useTimePicker(options?: UseTimePickerOptions): {
+    hours: number;
+    minutes: number;
+    seconds: number;
+    meridiem: "AM" | "PM";
+    setHours: (h: number) => void;
+    setMinutes: (m: number) => void;
+    setSeconds: (s: number) => void;
+    setMeridiem: (m: "AM" | "PM") => void;
+    formattedValue: string;
+    availableHours: number[];
+    availableMinutes: number[];
+    availableSeconds: number[];
+    showSeconds: boolean;
+    format: "12h" | "24h";
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    getInputProps: () => {
+        type: "text";
+        value: string;
+        placeholder: string;
+        readOnly: true;
+        'aria-label': string;
+        'aria-haspopup': "listbox";
+        'aria-expanded': boolean;
+        onClick: () => void;
+    };
+    getTimeOptionProps: (type: "hours" | "minutes" | "seconds" | "meridiem", value: number | string) => {
+        type: "button";
+        role: "option";
+        'aria-selected': boolean;
+        'data-active': true | undefined;
+        onClick: () => void;
+    };
+    selectedTime: Date | null;
+};
+type UseTimePickerReturn = ReturnType<typeof useTimePicker>;
+
+interface UseDateTimePickerOptions extends Omit<UseDatePickerOptions, 'format'> {
+    dateFormat?: string;
+    timeFormat?: '12h' | '24h';
+    minuteStep?: number;
+    showSeconds?: boolean;
+}
+declare function useDateTimePicker(options?: UseDateTimePickerOptions): {
+    formattedValue: string;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    meridiem: "AM" | "PM";
+    setHours: (h: number) => void;
+    setMinutes: (m: number) => void;
+    setSeconds: (s: number) => void;
+    setMeridiem: (m: "AM" | "PM") => void;
+    activeTab: "time" | "date";
+    setActiveTab: react.Dispatch<react.SetStateAction<"time" | "date">>;
+    timeFormat: "12h" | "24h";
+    minuteStep: number;
+    showSeconds: boolean;
+    selectedDate: Date | null;
+    selectDate: (date: Date) => void;
+    clearDate: () => void;
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    isSelected: (date: Date) => boolean;
+    getInputProps: () => {
+        type: "text";
+        value: string;
+        placeholder: string;
+        readOnly: boolean;
+        'aria-label': string;
+        'aria-haspopup': "dialog";
+        'aria-expanded': boolean;
+        autoComplete: "off";
+        onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+        onFocus: () => void;
+        onBlur: () => void;
+        onClick: () => void;
+    };
+    getPopoverProps: () => {
+        role: "dialog";
+        'aria-modal': true;
+        'aria-label': string;
+    };
+    getHiddenInputProps: () => {
+        type: "hidden";
+        name: string | undefined;
+        value: string;
+    };
+    clearable: boolean;
+    required: boolean;
+    months: CalendarMonth[];
+    focusedDate: Date | null;
+    viewingYear: number;
+    viewingMonth: number;
+    goToNextMonth: () => void;
+    goToPrevMonth: () => void;
+    goToNextYear: () => void;
+    goToPrevYear: () => void;
+    goToMonth: (month: number) => void;
+    goToYear: (year: number) => void;
+    goToDate: (date: Date) => void;
+    goToToday: () => void;
+    setFocusedDate: (date: Date | null) => void;
+    isDateDisabled: (date: Date) => boolean;
+    isDateHighlighted: (date: Date) => boolean;
+    isOutsideRange: (date: Date) => boolean;
+    locale: DatePickerLocale;
+};
+type UseDateTimePickerReturn = ReturnType<typeof useDateTimePicker>;
+
+interface UseMonthPickerOptions {
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (date: Date | null) => void;
+    minDate?: Date;
+    maxDate?: Date;
+    format?: string;
+    locale?: DatePickerLocale;
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function useMonthPicker(options?: UseMonthPickerOptions): {
+    viewingYear: number;
+    selectedDate: Date | null;
+    monthGrid: {
+        isDisabled: boolean;
+        isSelected: boolean;
+        date: Date;
+        month: number;
+        label: string;
+    }[];
+    goToNextYear: () => void;
+    goToPrevYear: () => void;
+    selectMonth: (month: number) => void;
+    formattedValue: string;
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    getInputProps: () => {
+        type: "text";
+        value: string;
+        readOnly: true;
+        'aria-label': string;
+        'aria-haspopup': "dialog";
+        'aria-expanded': boolean;
+        onClick: () => void;
+    };
+    getMonthButtonProps: (month: number) => {
+        type: "button";
+        'aria-selected': boolean;
+        'aria-disabled': boolean;
+        disabled: boolean;
+        onClick: () => void;
+    };
+    locale: DatePickerLocale;
+};
+type UseMonthPickerReturn = ReturnType<typeof useMonthPicker>;
+
+interface UseYearPickerOptions {
+    value?: number | null;
+    defaultValue?: number | null;
+    onChange?: (year: number | null) => void;
+    minYear?: number;
+    maxYear?: number;
+    yearsPerPage?: number;
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function useYearPicker(options?: UseYearPickerOptions): {
+    decadeStart: number;
+    selectedYear: number | null;
+    years: {
+        isDisabled: boolean;
+        isSelected: boolean;
+        isCurrentYear: boolean;
+        year: number;
+    }[];
+    goToNextDecade: () => void;
+    goToPrevDecade: () => void;
+    selectYear: (year: number) => void;
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    getInputProps: () => {
+        type: "text";
+        value: string;
+        readOnly: true;
+        'aria-label': string;
+        'aria-haspopup': "dialog";
+        'aria-expanded': boolean;
+        onClick: () => void;
+    };
+    getYearButtonProps: (year: number) => {
+        type: "button";
+        'aria-selected': boolean;
+        'aria-disabled': boolean;
+        disabled: boolean;
+        onClick: () => void;
+    };
+};
+type UseYearPickerReturn = ReturnType<typeof useYearPicker>;
+
+interface UseWeekPickerOptions extends UseCalendarOptions {
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (weekStart: Date, weekEnd: Date, weekNumber: number) => void;
+    format?: string;
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function useWeekPicker(options?: UseWeekPickerOptions): {
+    selectedWeek: {
+        start: Date;
+        end: Date;
+        weekNumber: number;
+    } | null;
+    selectWeek: (date: Date) => void;
+    isInSelectedWeek: (date: Date) => boolean;
+    formattedValue: string;
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    getInputProps: () => {
+        type: "text";
+        value: string;
+        readOnly: true;
+        'aria-label': string;
+        'aria-haspopup': "dialog";
+        'aria-expanded': boolean;
+        onClick: () => void;
+    };
+    months: CalendarMonth[];
+    focusedDate: Date | null;
+    viewingYear: number;
+    viewingMonth: number;
+    goToNextMonth: () => void;
+    goToPrevMonth: () => void;
+    goToNextYear: () => void;
+    goToPrevYear: () => void;
+    goToMonth: (month: number) => void;
+    goToYear: (year: number) => void;
+    goToDate: (date: Date) => void;
+    goToToday: () => void;
+    setFocusedDate: (date: Date | null) => void;
+    isDateDisabled: (date: Date) => boolean;
+    isDateHighlighted: (date: Date) => boolean;
+    isOutsideRange: (date: Date) => boolean;
+    locale: DatePickerLocale;
+};
+type UseWeekPickerReturn = ReturnType<typeof useWeekPicker>;
+
+declare function useControllable<T>(options: {
+    value?: T;
+    defaultValue: T;
+    onChange?: (value: T) => void;
+}): [T, (value: T) => void];
+
+interface UseKeyboardNavOptions {
+    focusedDate: Date;
+    onFocusChange: (date: Date) => void;
+    onSelect: (date: Date) => void;
+    onClose?: () => void;
+    weekStartsOn?: WeekDay;
+    minDate?: Date;
+    maxDate?: Date;
+    disabled?: DateMatcher | DateMatcher[];
+}
+declare function useKeyboardNav(options: UseKeyboardNavOptions): {
+    handleKeyDown: (event: React.KeyboardEvent) => void;
+};
+
+interface UseMultiPickerOptions extends UseCalendarOptions {
+    value?: Date[];
+    defaultValue?: Date[];
+    onChange?: (dates: Date[]) => void;
+    maxSelections?: number;
+    format?: string;
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function useMultiPicker(options?: UseMultiPickerOptions): {
+    selectedDates: Date[];
+    toggleDate: (date: Date) => void;
+    removeDate: (date: Date) => void;
+    clearAll: () => void;
+    isSelected: (date: Date) => boolean;
+    formattedValues: string[];
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    months: CalendarMonth[];
+    focusedDate: Date | null;
+    viewingYear: number;
+    viewingMonth: number;
+    goToNextMonth: () => void;
+    goToPrevMonth: () => void;
+    goToNextYear: () => void;
+    goToPrevYear: () => void;
+    goToMonth: (month: number) => void;
+    goToYear: (year: number) => void;
+    goToDate: (date: Date) => void;
+    goToToday: () => void;
+    setFocusedDate: (date: Date | null) => void;
+    isDateDisabled: (date: Date) => boolean;
+    isDateHighlighted: (date: Date) => boolean;
+    isOutsideRange: (date: Date) => boolean;
+    locale: DatePickerLocale;
+};
+type UseMultiPickerReturn = ReturnType<typeof useMultiPicker>;
+
+declare function useClickOutside(refs: React.RefObject<HTMLElement | null>[], handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;
+
+declare function usePortal(options?: {
+    containerId?: string;
+    enabled?: boolean;
+}): {
+    portalTarget: HTMLElement | null;
+    isPortalReady: boolean;
+};
+
+declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, enabled?: boolean): void;
+
+export { type UseCalendarOptions, type UseCalendarReturn, type UseDatePickerOptions, type UseDatePickerReturn, type UseDateTimePickerOptions, type UseDateTimePickerReturn, type UseKeyboardNavOptions, type UseMonthPickerOptions, type UseMonthPickerReturn, type UseMultiPickerOptions, type UseMultiPickerReturn, type UseRangePickerOptions, type UseRangePickerReturn, type UseTimePickerOptions, type UseTimePickerReturn, type UseWeekPickerOptions, type UseWeekPickerReturn, type UseYearPickerOptions, type UseYearPickerReturn, useCalendar, useClickOutside, useControllable, useDatePicker, useDateTimePicker, useFocusTrap, useKeyboardNav, useMonthPicker, useMultiPicker, usePortal, useRangePicker, useTimePicker, useWeekPicker, useYearPicker };

package/dist/hooks.js

@@ -0,0 +1,5 @@
+export { useCalendar, useClickOutside, useControllable, useDatePicker, useDateTimePicker, useFocusTrap, useKeyboardNav, useMonthPicker, useMultiPicker, usePortal, useRangePicker, useTimePicker, useWeekPicker, useYearPicker } from './chunk-FBN3SFQJ.js';
+import './chunk-W6KEY2SO.js';
+import './chunk-QW2CUEX4.js';
+//# sourceMappingURL=hooks.js.map
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"hooks.js"}