best-react-datepicker 0.2.0

package/dist/hooks.cjs

@@ -0,0 +1,66 @@
+'use strict';
+
+var chunkA3NQUSC5_cjs = require('./chunk-A3NQUSC5.cjs');
+require('./chunk-HI4J64KK.cjs');
+require('./chunk-R7HLYS5V.cjs');
+
+
+
+Object.defineProperty(exports, "useCalendar", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useCalendar; }
+});
+Object.defineProperty(exports, "useClickOutside", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useClickOutside; }
+});
+Object.defineProperty(exports, "useControllable", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useControllable; }
+});
+Object.defineProperty(exports, "useDatePicker", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useDatePicker; }
+});
+Object.defineProperty(exports, "useDateTimePicker", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useDateTimePicker; }
+});
+Object.defineProperty(exports, "useFocusTrap", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useFocusTrap; }
+});
+Object.defineProperty(exports, "useKeyboardNav", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useKeyboardNav; }
+});
+Object.defineProperty(exports, "useMonthPicker", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useMonthPicker; }
+});
+Object.defineProperty(exports, "useMultiPicker", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useMultiPicker; }
+});
+Object.defineProperty(exports, "usePortal", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.usePortal; }
+});
+Object.defineProperty(exports, "useRangePicker", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useRangePicker; }
+});
+Object.defineProperty(exports, "useTimePicker", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useTimePicker; }
+});
+Object.defineProperty(exports, "useWeekPicker", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useWeekPicker; }
+});
+Object.defineProperty(exports, "useYearPicker", {
+  enumerable: true,
+  get: function () { return chunkA3NQUSC5_cjs.useYearPicker; }
+});
+//# sourceMappingURL=hooks.cjs.map
+//# sourceMappingURL=hooks.cjs.map

package/dist/hooks.cjs.map

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

package/dist/hooks.d.cts

@@ -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.cjs';
+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 };