flexible-multi-calendar-datepicker 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,124 @@
+import * as React from 'react';
+import React__default from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type CalendarSystem = "jalali" | "islamic" | "gregorian";
+type CalendarLocale = "fa" | "en";
+type IslamicDateAdjustment = -2 | -1 | 0 | 1 | 2;
+
+type AnchorRef = React.RefObject<HTMLElement> | React.MutableRefObject<HTMLElement | null>;
+type JalaliDisabledDateRange = {
+    /** First disabled day (inclusive). */
+    from: Date;
+    /** Last disabled day (inclusive). */
+    to: Date;
+};
+type JalaliDatepickerProps = {
+    open: boolean;
+    anchorRef: AnchorRef;
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (d: Date | null) => void;
+    onConfirm: (d: Date | null) => void;
+    onClose: () => void;
+    /** Optional per-instance label. Pass an empty string or null to hide it. */
+    label?: React.ReactNode;
+    locale?: "fa" | "en";
+    /** Calendar system. Existing integrations default to Jalali. */
+    calendar?: CalendarSystem;
+    /**
+     * Moves calculated Islamic dates by -2..+2 days to match a local or
+     * officially announced lunar calendar. Only used with calendar="islamic".
+     */
+    islamicDateAdjustment?: IslamicDateAdjustment;
+    className?: string;
+    style?: React.CSSProperties;
+    /** محل اختیاری Portal؛ پیش‌فرض document.body است. */
+    portalContainer?: HTMLElement | null;
+    /**
+     * نمایش دکمه‌های تأیید و انصراف.
+     * false: انتخاب روز فوراً مقدار را ارسال می‌کند و تقویم بسته می‌شود.
+     * true: مقدار فقط با تأیید ارسال می‌شود و انصراف state مقصد را تغییر نمی‌دهد.
+     * @default false
+     */
+    showActionButtons?: boolean;
+    /** Date ranges that cannot be selected. Both boundaries are included. */
+    disabledDateRanges?: readonly JalaliDisabledDateRange[];
+    labels?: {
+        titleFrom?: string;
+        titleTo?: string;
+        confirm?: string;
+        cancel?: string;
+        chooseDate?: string;
+        today?: string;
+    };
+};
+declare function JalaliDatepicker(props: JalaliDatepickerProps): React.ReactPortal | null;
+declare const _default: React.MemoExoticComponent<typeof JalaliDatepicker>;
+
+type Option = {
+    id: string | number;
+    label: React__default.ReactNode;
+    value?: string;
+    disabled?: boolean;
+};
+type SingleChange = {
+    id: string | number | null;
+    value: string | null;
+    label?: string | null;
+};
+type MultiChange = {
+    ids: Array<string | number>;
+    values: string[];
+    labels: string[];
+};
+type BaseProps = {
+    name?: string;
+    options: ReadonlyArray<Option>;
+    dir?: "rtl" | "ltr";
+    disabled?: boolean;
+    placeholderLabel?: string;
+    hasPlaceholder?: boolean;
+    showCheckIcon?: boolean;
+    colorVar?: string;
+    required?: boolean;
+    containerStyle?: React__default.CSSProperties;
+    className?: string;
+    listClassName?: string;
+    style?: React__default.CSSProperties;
+    placement?: "down" | "up" | "auto";
+    panelOffset?: number;
+};
+type SingleProps = {
+    multi?: false;
+    defaultSelectedId?: string | number | null;
+    selectedId?: string | number | null;
+    onChange?: (sel: SingleChange) => void;
+};
+type MultiProps = {
+    multi: true;
+    defaultSelectedIds?: Array<string | number> | null;
+    selectedIds?: Array<string | number> | null;
+    onChange?: (sel: MultiChange) => void;
+};
+type ComboSelectProps = BaseProps & (SingleProps | MultiProps);
+declare function ComboSelectImpl(props: ComboSelectProps): react_jsx_runtime.JSX.Element;
+declare const ComboSelect: React__default.MemoExoticComponent<typeof ComboSelectImpl>;
+
+declare const ArrowDownCombo: React.FC<React.SVGProps<SVGSVGElement>>;
+declare const TickCircle: React.FC<React.SVGProps<SVGSVGElement>>;
+
+type CalendarDisplayFormat = "YYYY-MM-DD" | "YYYY/MM/DD" | "DD/MM/YYYY" | "DD MMM YYYY" | "MMMM DD, YYYY" | "dddd, DD MMMM YYYY" | "dddd DD MMMM YYYY";
+type JalaliDisplayFormat = CalendarDisplayFormat;
+type JalaliFormatLocale = CalendarLocale;
+type CalendarFormatOptions = {
+    calendar?: CalendarSystem;
+    locale?: CalendarLocale;
+    islamicDateAdjustment?: IslamicDateAdjustment;
+};
+declare function formatCalendarDate(date: Date | null | undefined, format?: CalendarDisplayFormat, options?: CalendarFormatOptions): string;
+declare function parseCalendarDate(input: string, format: CalendarDisplayFormat, options?: CalendarFormatOptions): Date | null;
+declare function formatJalaliDate(date: Date | null | undefined, format?: JalaliDisplayFormat, locale?: JalaliFormatLocale): string;
+declare function parseJalaliDate(input: string, format: JalaliDisplayFormat, locale?: JalaliFormatLocale): Date | null;
+
+export { ArrowDownCombo, type CalendarDisplayFormat, type CalendarFormatOptions, type CalendarLocale, type CalendarSystem, ComboSelect, type MultiChange as ComboSelectMultiChange, type Option as ComboSelectOption, type ComboSelectProps, type SingleChange as ComboSelectSingleChange, type IslamicDateAdjustment, _default as JalaliDatepicker, type JalaliDatepickerProps, type JalaliDisabledDateRange, type JalaliDisplayFormat, type JalaliFormatLocale, _default as PersianDatepicker, TickCircle, formatCalendarDate, formatJalaliDate, parseCalendarDate, parseJalaliDate };

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+import * as React from 'react';
+import React__default from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type CalendarSystem = "jalali" | "islamic" | "gregorian";
+type CalendarLocale = "fa" | "en";
+type IslamicDateAdjustment = -2 | -1 | 0 | 1 | 2;
+
+type AnchorRef = React.RefObject<HTMLElement> | React.MutableRefObject<HTMLElement | null>;
+type JalaliDisabledDateRange = {
+    /** First disabled day (inclusive). */
+    from: Date;
+    /** Last disabled day (inclusive). */
+    to: Date;
+};
+type JalaliDatepickerProps = {
+    open: boolean;
+    anchorRef: AnchorRef;
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (d: Date | null) => void;
+    onConfirm: (d: Date | null) => void;
+    onClose: () => void;
+    /** Optional per-instance label. Pass an empty string or null to hide it. */
+    label?: React.ReactNode;
+    locale?: "fa" | "en";
+    /** Calendar system. Existing integrations default to Jalali. */
+    calendar?: CalendarSystem;
+    /**
+     * Moves calculated Islamic dates by -2..+2 days to match a local or
+     * officially announced lunar calendar. Only used with calendar="islamic".
+     */
+    islamicDateAdjustment?: IslamicDateAdjustment;
+    className?: string;
+    style?: React.CSSProperties;
+    /** محل اختیاری Portal؛ پیش‌فرض document.body است. */
+    portalContainer?: HTMLElement | null;
+    /**
+     * نمایش دکمه‌های تأیید و انصراف.
+     * false: انتخاب روز فوراً مقدار را ارسال می‌کند و تقویم بسته می‌شود.
+     * true: مقدار فقط با تأیید ارسال می‌شود و انصراف state مقصد را تغییر نمی‌دهد.
+     * @default false
+     */
+    showActionButtons?: boolean;
+    /** Date ranges that cannot be selected. Both boundaries are included. */
+    disabledDateRanges?: readonly JalaliDisabledDateRange[];
+    labels?: {
+        titleFrom?: string;
+        titleTo?: string;
+        confirm?: string;
+        cancel?: string;
+        chooseDate?: string;
+        today?: string;
+    };
+};
+declare function JalaliDatepicker(props: JalaliDatepickerProps): React.ReactPortal | null;
+declare const _default: React.MemoExoticComponent<typeof JalaliDatepicker>;
+
+type Option = {
+    id: string | number;
+    label: React__default.ReactNode;
+    value?: string;
+    disabled?: boolean;
+};
+type SingleChange = {
+    id: string | number | null;
+    value: string | null;
+    label?: string | null;
+};
+type MultiChange = {
+    ids: Array<string | number>;
+    values: string[];
+    labels: string[];
+};
+type BaseProps = {
+    name?: string;
+    options: ReadonlyArray<Option>;
+    dir?: "rtl" | "ltr";
+    disabled?: boolean;
+    placeholderLabel?: string;
+    hasPlaceholder?: boolean;
+    showCheckIcon?: boolean;
+    colorVar?: string;
+    required?: boolean;
+    containerStyle?: React__default.CSSProperties;
+    className?: string;
+    listClassName?: string;
+    style?: React__default.CSSProperties;
+    placement?: "down" | "up" | "auto";
+    panelOffset?: number;
+};
+type SingleProps = {
+    multi?: false;
+    defaultSelectedId?: string | number | null;
+    selectedId?: string | number | null;
+    onChange?: (sel: SingleChange) => void;
+};
+type MultiProps = {
+    multi: true;
+    defaultSelectedIds?: Array<string | number> | null;
+    selectedIds?: Array<string | number> | null;
+    onChange?: (sel: MultiChange) => void;
+};
+type ComboSelectProps = BaseProps & (SingleProps | MultiProps);
+declare function ComboSelectImpl(props: ComboSelectProps): react_jsx_runtime.JSX.Element;
+declare const ComboSelect: React__default.MemoExoticComponent<typeof ComboSelectImpl>;
+
+declare const ArrowDownCombo: React.FC<React.SVGProps<SVGSVGElement>>;
+declare const TickCircle: React.FC<React.SVGProps<SVGSVGElement>>;
+
+type CalendarDisplayFormat = "YYYY-MM-DD" | "YYYY/MM/DD" | "DD/MM/YYYY" | "DD MMM YYYY" | "MMMM DD, YYYY" | "dddd, DD MMMM YYYY" | "dddd DD MMMM YYYY";
+type JalaliDisplayFormat = CalendarDisplayFormat;
+type JalaliFormatLocale = CalendarLocale;
+type CalendarFormatOptions = {
+    calendar?: CalendarSystem;
+    locale?: CalendarLocale;
+    islamicDateAdjustment?: IslamicDateAdjustment;
+};
+declare function formatCalendarDate(date: Date | null | undefined, format?: CalendarDisplayFormat, options?: CalendarFormatOptions): string;
+declare function parseCalendarDate(input: string, format: CalendarDisplayFormat, options?: CalendarFormatOptions): Date | null;
+declare function formatJalaliDate(date: Date | null | undefined, format?: JalaliDisplayFormat, locale?: JalaliFormatLocale): string;
+declare function parseJalaliDate(input: string, format: JalaliDisplayFormat, locale?: JalaliFormatLocale): Date | null;
+
+export { ArrowDownCombo, type CalendarDisplayFormat, type CalendarFormatOptions, type CalendarLocale, type CalendarSystem, ComboSelect, type MultiChange as ComboSelectMultiChange, type Option as ComboSelectOption, type ComboSelectProps, type SingleChange as ComboSelectSingleChange, type IslamicDateAdjustment, _default as JalaliDatepicker, type JalaliDatepickerProps, type JalaliDisabledDateRange, type JalaliDisplayFormat, type JalaliFormatLocale, _default as PersianDatepicker, TickCircle, formatCalendarDate, formatJalaliDate, parseCalendarDate, parseJalaliDate };