react-day-picker 9.13.1 → 9.14.0

package/README.md

@@ -18,7 +18,7 @@ See **[daypicker.dev](https://daypicker.dev)** for guides, examples and API refe
 - 🎨 Minimal design that can be [easily styled](https://daypicker.dev/docs/styling) with CSS or any CSS framework.
 - 📅 Supports [selections](https://daypicker.dev/docs/selection-modes) of single days, multiple days, ranges of days, or [custom selections](https://daypicker.dev/guides/custom-selections).
 - 🌍 Can be [localized](https://daypicker.dev/docs/localization) into any language and [time zones](https://daypicker.dev/docs/time-zone).
-- 🌐 Support for [ISO 8601](http://daypicker.dev/localization/iso-and-broadcast#iso-8601-calendar), [Persian](http://daypicker.dev/localization/persian), [Buddhist (Thai)](http://daypicker.dev/localization/buddhist), [Ethiopic](http://daypicker.dev/localization/ethiopic), [Hebrew](http://daypicker.dev/localization/hebrew) and [broadcast](http://daypicker.dev/localization/iso-and-broadcast#broadcast-calendar) calendar.
+- 🌐 Support for [ISO 8601](http://daypicker.dev/localization/iso-and-broadcast#iso-8601-calendar), [Persian](http://daypicker.dev/localization/persian), [Hijri](http://daypicker.dev/localization/hijri), [Buddhist (Thai)](http://daypicker.dev/localization/buddhist), [Ethiopic](http://daypicker.dev/localization/ethiopic), [Hebrew](http://daypicker.dev/localization/hebrew) and [broadcast](http://daypicker.dev/localization/iso-and-broadcast#broadcast-calendar) calendar.
 - 🦮 Complies with WCAG 2.1 AA requirements for [accessibility](https://daypicker.dev/guides/accessibility).
 - ⚙️ [Customizable components](https://daypicker.dev/guides/custom-components) to extend the rendered elements.
 - 🔤 Easy integration [with input fields](https://daypicker.dev/guides/input-fields).

package/dist/cjs/DayPicker.js

@@ -279,7 +279,7 @@ function DayPicker(initialProps) {
         formatters,
     };
     return (react_1.default.createElement(useDayPicker_js_1.dayPickerContext.Provider, { value: contextValue },
-        react_1.default.createElement(components.Root, { rootRef: props.animate ? rootElRef : undefined, className: className, style: style, dir: props.dir, id: props.id, lang: props.lang, nonce: props.nonce, title: props.title, role: props.role, "aria-label": props["aria-label"], "aria-labelledby": props["aria-labelledby"], ...dataAttributes },
+        react_1.default.createElement(components.Root, { rootRef: props.animate ? rootElRef : undefined, className: className, style: style, dir: props.dir, id: props.id, lang: props.lang ?? locale.code, nonce: props.nonce, title: props.title, role: props.role, "aria-label": props["aria-label"], "aria-labelledby": props["aria-labelledby"], ...dataAttributes },
             react_1.default.createElement(components.Months, { className: classNames[UI_js_1.UI.Months], style: styles?.[UI_js_1.UI.Months] },
                 !props.hideNavigation && !navLayout && (react_1.default.createElement(components.Nav, { "data-animated-nav": props.animate ? "true" : undefined, className: classNames[UI_js_1.UI.Nav], style: styles?.[UI_js_1.UI.Nav], "aria-label": labelNav(), onPreviousClick: handlePreviousClick, onNextClick: handleNextClick, previousMonth: previousMonth, nextMonth: nextMonth })),
                 months.map((calendarMonth, displayIndex) => {

package/dist/cjs/UI.d.ts

@@ -80,8 +80,8 @@ export declare enum DayFlag {
     today = "today"
 }
 /**
- * Enum representing selection states that can be applied to the {@link UI | UI.Day}
- * element in selection mode.
+ * Enum representing selection states that can be applied to the
+ * {@link UI | UI.Day} element in selection mode.
  */
 export declare enum SelectionState {
     /** The day is at the end of a selected range. */
@@ -131,14 +131,16 @@ export declare enum Animation {
 export type DeprecatedUI<T extends CSSProperties | string> = {
     /**
      * This element was applied to the style of any button in DayPicker and it is
-     * replaced by {@link UI | UI.PreviousMonthButton} and {@link UI | UI.NextMonthButton}.
+     * replaced by {@link UI | UI.PreviousMonthButton} and
+     * {@link UI | UI.NextMonthButton}.
      *
      * @deprecated
      */
     button: T;
     /**
      * This element was resetting the style of any button in DayPicker and it is
-     * replaced by {@link UI | UI.PreviousMonthButton} and {@link UI | UI.NextMonthButton}.
+     * replaced by {@link UI | UI.PreviousMonthButton} and
+     * {@link UI | UI.NextMonthButton}.
      *
      * @deprecated
      */
@@ -200,25 +202,29 @@ export type DeprecatedUI<T extends CSSProperties | string> = {
      */
     day_outside: T;
     /**
-     * This element has been renamed to {@link SelectionState | SelectionState.range_end}.
+     * This element has been renamed to
+     * {@link SelectionState | SelectionState.range_end}.
      *
      * @deprecated
      */
     day_range_end: T;
     /**
-     * This element has been renamed to {@link SelectionState | SelectionState.range_middle}.
+     * This element has been renamed to
+     * {@link SelectionState | SelectionState.range_middle}.
      *
      * @deprecated
      */
     day_range_middle: T;
     /**
-     * This element has been renamed to {@link SelectionState | SelectionState.range_start}.
+     * This element has been renamed to
+     * {@link SelectionState | SelectionState.range_start}.
      *
      * @deprecated
      */
     day_range_start: T;
     /**
-     * This element has been renamed to {@link SelectionState | SelectionState.selected}.
+     * This element has been renamed to
+     * {@link SelectionState | SelectionState.selected}.
      *
      * @deprecated
      */
@@ -230,8 +236,8 @@ export type DeprecatedUI<T extends CSSProperties | string> = {
      */
     day_today: T;
     /**
-     * This element has been removed. The dropdown icon is now {@link UI | UI.Chevron}
-     * inside a {@link UI | UI.CaptionLabel}.
+     * This element has been removed. The dropdown icon is now
+     * {@link UI | UI.Chevron} inside a {@link UI | UI.CaptionLabel}.
      *
      * @deprecated
      */
@@ -293,8 +299,9 @@ export type DeprecatedUI<T extends CSSProperties | string> = {
      */
     nav_button_previous: T;
     /**
-     * This element has been removed. The dropdown icon is now {@link UI | UI.Chevron}
-     * inside a {@link UI | UI.NextMonthButton} or a {@link UI | UI.PreviousMonthButton}.
+     * This element has been removed. The dropdown icon is now
+     * {@link UI | UI.Chevron} inside a {@link UI | UI.NextMonthButton} or a
+     * {@link UI | UI.PreviousMonthButton}.
      *
      * @deprecated
      */
@@ -318,8 +325,8 @@ export type DeprecatedUI<T extends CSSProperties | string> = {
      */
     tbody: T;
     /**
-     * This element has been removed. The {@link UI | UI.Footer} is now a single element
-     * below the months.
+     * This element has been removed. The {@link UI | UI.Footer} is now a single
+     * element below the months.
      *
      * @deprecated
      */

package/dist/cjs/UI.js

@@ -84,8 +84,8 @@ var DayFlag;
     DayFlag["today"] = "today";
 })(DayFlag || (exports.DayFlag = DayFlag = {}));
 /**
- * Enum representing selection states that can be applied to the {@link UI | UI.Day}
- * element in selection mode.
+ * Enum representing selection states that can be applied to the
+ * {@link UI | UI.Day} element in selection mode.
  */
 var SelectionState;
 (function (SelectionState) {

package/dist/cjs/hijri/index.d.ts

@@ -0,0 +1,28 @@
+import type { Locale } from "date-fns";
+import React from "react";
+import { DateLib, type DateLibOptions } from "../index.js";
+import type { DayPickerProps } from "../types/props.js";
+/**
+ * Render the Hijri (Umm al-Qura) calendar.
+ *
+ * Defaults:
+ *
+ * - `locale`: `ar-SA`
+ * - `dir`: `rtl`
+ * - `numerals`: `arab`
+ * - `startMonth`: `1924-08-01`
+ * - `endMonth`: `2077-11-16`
+ *
+ * Out-of-range date props are clamped to the supported Umm al-Qura conversion
+ * range, preventing runtime conversion errors.
+ */
+export declare function DayPicker(props: DayPickerProps & {
+    locale?: Locale;
+    dir?: DayPickerProps["dir"];
+    numerals?: DayPickerProps["numerals"];
+    dateLib?: DayPickerProps["dateLib"];
+}): React.JSX.Element;
+/** Returns the date library used in the Hijri calendar. */
+export declare const getDateLib: (options?: DateLibOptions) => DateLib;
+export { arSA } from "../locale/ar-SA.js";
+export { enUS } from "../locale/en-US.js";

package/dist/cjs/hijri/index.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enUS = exports.arSA = exports.getDateLib = void 0;
+exports.DayPicker = DayPicker;
+const react_1 = __importDefault(require("react"));
+const index_js_1 = require("../index.js");
+const ar_SA_js_1 = require("../locale/ar-SA.js");
+const hijriDateLib = __importStar(require("./lib/index.js"));
+const range_js_1 = require("./utils/range.js");
+function clampDateProp(date) {
+    if (!date) {
+        return undefined;
+    }
+    return (0, range_js_1.clampGregorianDate)(date);
+}
+/**
+ * Render the Hijri (Umm al-Qura) calendar.
+ *
+ * Defaults:
+ *
+ * - `locale`: `ar-SA`
+ * - `dir`: `rtl`
+ * - `numerals`: `arab`
+ * - `startMonth`: `1924-08-01`
+ * - `endMonth`: `2077-11-16`
+ *
+ * Out-of-range date props are clamped to the supported Umm al-Qura conversion
+ * range, preventing runtime conversion errors.
+ */
+function DayPicker(props) {
+    const { dateLib: dateLibProp, ...dayPickerProps } = props;
+    const hasStartBound = props.startMonth !== undefined ||
+        props.fromMonth !== undefined ||
+        props.fromYear !== undefined;
+    const hasEndBound = props.endMonth !== undefined ||
+        props.toMonth !== undefined ||
+        props.toYear !== undefined;
+    const clampedProps = {
+        ...dayPickerProps,
+        month: clampDateProp(props.month),
+        defaultMonth: clampDateProp(props.defaultMonth),
+        today: clampDateProp(props.today),
+        startMonth: hasStartBound
+            ? clampDateProp(props.startMonth)
+            : new Date(range_js_1.GREGORIAN_MIN_DATE),
+        endMonth: hasEndBound
+            ? clampDateProp(props.endMonth)
+            : new Date(range_js_1.GREGORIAN_MAX_DATE),
+        fromMonth: clampDateProp(props.fromMonth),
+        toMonth: clampDateProp(props.toMonth),
+    };
+    return (react_1.default.createElement(index_js_1.DayPicker, { ...clampedProps, locale: props.locale ?? ar_SA_js_1.arSA, numerals: props.numerals ?? "arab", dir: props.dir ?? "rtl", dateLib: { ...hijriDateLib, ...dateLibProp } }));
+}
+/** Returns the date library used in the Hijri calendar. */
+const getDateLib = (options) => {
+    return new index_js_1.DateLib(options, hijriDateLib);
+};
+exports.getDateLib = getDateLib;
+var ar_SA_js_2 = require("../locale/ar-SA.js");
+Object.defineProperty(exports, "arSA", { enumerable: true, get: function () { return ar_SA_js_2.arSA; } });
+var en_US_js_1 = require("../locale/en-US.js");
+Object.defineProperty(exports, "enUS", { enumerable: true, get: function () { return en_US_js_1.enUS; } });

package/dist/cjs/hijri/lib/addMonths.d.ts

@@ -0,0 +1 @@
+export declare function addMonths(date: Date, amount: number): Date;

package/dist/cjs/hijri/lib/addMonths.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addMonths = addMonths;
+const conversion_js_1 = require("../utils/conversion.js");
+const setMonth_js_1 = require("./setMonth.js");
+function addMonths(date, amount) {
+    const hijri = (0, conversion_js_1.toHijriDate)(date);
+    return (0, setMonth_js_1.setMonth)(date, hijri.monthIndex + amount);
+}

package/dist/cjs/hijri/lib/addYears.d.ts

@@ -0,0 +1 @@
+export declare function addYears(date: Date, amount: number): Date;

package/dist/cjs/hijri/lib/addYears.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addYears = addYears;
+const conversion_js_1 = require("../utils/conversion.js");
+const setYear_js_1 = require("./setYear.js");
+function addYears(date, amount) {
+    const hijri = (0, conversion_js_1.toHijriDate)(date);
+    return (0, setYear_js_1.setYear)(date, hijri.year + amount);
+}

package/dist/cjs/hijri/lib/differenceInCalendarMonths.d.ts

@@ -0,0 +1 @@
+export declare function differenceInCalendarMonths(dateLeft: Date, dateRight: Date): number;

package/dist/cjs/hijri/lib/differenceInCalendarMonths.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.differenceInCalendarMonths = differenceInCalendarMonths;
+const conversion_js_1 = require("../utils/conversion.js");
+function differenceInCalendarMonths(dateLeft, dateRight) {
+    const hijriLeft = (0, conversion_js_1.toHijriDate)(dateLeft);
+    const hijriRight = (0, conversion_js_1.toHijriDate)(dateRight);
+    return ((hijriLeft.year - hijriRight.year) * 12 +
+        (hijriLeft.monthIndex - hijriRight.monthIndex));
+}

package/dist/cjs/hijri/lib/eachMonthOfInterval.d.ts

@@ -0,0 +1,2 @@
+import { type Interval } from "date-fns";
+export declare function eachMonthOfInterval(interval: Interval): Date[];

package/dist/cjs/hijri/lib/eachMonthOfInterval.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eachMonthOfInterval = eachMonthOfInterval;
+const date_fns_1 = require("date-fns");
+const conversion_js_1 = require("../utils/conversion.js");
+function eachMonthOfInterval(interval) {
+    const start = (0, date_fns_1.toDate)(interval.start);
+    const end = (0, date_fns_1.toDate)(interval.end);
+    if (end.getTime() < start.getTime()) {
+        throw new RangeError("Invalid interval");
+    }
+    const startDate = (0, conversion_js_1.toHijriDate)(start);
+    const endDate = (0, conversion_js_1.toHijriDate)(end);
+    const months = [];
+    let currentYear = startDate.year;
+    let currentMonth = startDate.monthIndex;
+    const endYear = endDate.year;
+    const endMonth = endDate.monthIndex;
+    while (currentYear < endYear ||
+        (currentYear === endYear && currentMonth <= endMonth)) {
+        months.push((0, conversion_js_1.toGregorianDate)({ year: currentYear, monthIndex: currentMonth, day: 1 }));
+        currentMonth += 1;
+        if (currentMonth > 11) {
+            currentMonth = 0;
+            currentYear += 1;
+        }
+    }
+    return months;
+}

package/dist/cjs/hijri/lib/eachYearOfInterval.d.ts

@@ -0,0 +1,2 @@
+import { type Interval } from "date-fns";
+export declare function eachYearOfInterval(interval: Interval): Date[];

package/dist/cjs/hijri/lib/eachYearOfInterval.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eachYearOfInterval = eachYearOfInterval;
+const date_fns_1 = require("date-fns");
+const conversion_js_1 = require("../utils/conversion.js");
+function eachYearOfInterval(interval) {
+    const start = (0, date_fns_1.toDate)(interval.start);
+    const end = (0, date_fns_1.toDate)(interval.end);
+    if (end.getTime() < start.getTime()) {
+        return [];
+    }
+    const startYear = (0, conversion_js_1.toHijriDate)(start).year;
+    const endYear = (0, conversion_js_1.toHijriDate)(end).year;
+    const years = [];
+    for (let year = startYear; year <= endYear; year += 1) {
+        years.push((0, conversion_js_1.toGregorianDate)({ year, monthIndex: 0, day: 1 }));
+    }
+    return years;
+}

package/dist/cjs/hijri/lib/endOfMonth.d.ts

@@ -0,0 +1 @@
+export declare function endOfMonth(date: Date): Date;

package/dist/cjs/hijri/lib/endOfMonth.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endOfMonth = endOfMonth;
+const conversion_js_1 = require("../utils/conversion.js");
+const daysInMonth_js_1 = require("../utils/daysInMonth.js");
+function endOfMonth(date) {
+    const hijri = (0, conversion_js_1.toHijriDate)(date);
+    const day = (0, daysInMonth_js_1.getDaysInMonth)(hijri.year, hijri.monthIndex);
+    return (0, conversion_js_1.toGregorianDate)({
+        year: hijri.year,
+        monthIndex: hijri.monthIndex,
+        day,
+    });
+}

package/dist/cjs/hijri/lib/endOfYear.d.ts

@@ -0,0 +1 @@
+export declare function endOfYear(date: Date): Date;

package/dist/cjs/hijri/lib/endOfYear.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endOfYear = endOfYear;
+const conversion_js_1 = require("../utils/conversion.js");
+const daysInMonth_js_1 = require("../utils/daysInMonth.js");
+function endOfYear(date) {
+    const hijri = (0, conversion_js_1.toHijriDate)(date);
+    const day = (0, daysInMonth_js_1.getDaysInMonth)(hijri.year, 11);
+    return (0, conversion_js_1.toGregorianDate)({
+        year: hijri.year,
+        monthIndex: 11,
+        day,
+    });
+}

package/dist/cjs/hijri/lib/fallbackLocaleData.d.ts

@@ -0,0 +1,5 @@
+export type FallbackLocaleCode = "ar" | "en";
+export type IntlNameWidth = "long" | "short" | "narrow";
+export declare const getFallbackLocaleCode: (localeCode: string) => FallbackLocaleCode;
+export declare const getFallbackMonthName: (date: Date, localeCode: string, width: IntlNameWidth) => string;
+export declare const getFallbackWeekdayName: (date: Date, localeCode: string, width: IntlNameWidth) => string;

package/dist/cjs/hijri/lib/fallbackLocaleData.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFallbackWeekdayName = exports.getFallbackMonthName = exports.getFallbackLocaleCode = void 0;
+const conversion_js_1 = require("../utils/conversion.js");
+const fallbackMonthNames = {
+    en: {
+        long: [
+            "Muharram",
+            "Safar",
+            "Rabi I",
+            "Rabi II",
+            "Jumada I",
+            "Jumada II",
+            "Rajab",
+            "Shaban",
+            "Ramadan",
+            "Shawwal",
+            "Dhu al-Qadah",
+            "Dhu al-Hijjah",
+        ],
+        short: [
+            "Muh",
+            "Saf",
+            "Rab-I",
+            "Rab-II",
+            "Jum-I",
+            "Jum-II",
+            "Raj",
+            "Sha",
+            "Ram",
+            "Shw",
+            "Dhu-Q",
+            "Dhu-H",
+        ],
+        narrow: ["M", "S", "R", "R", "J", "J", "R", "S", "R", "S", "D", "D"],
+    },
+    ar: {
+        long: [
+            "محرم",
+            "صفر",
+            "ربيع الأول",
+            "ربيع الآخر",
+            "جمادى الأولى",
+            "جمادى الآخرة",
+            "رجب",
+            "شعبان",
+            "رمضان",
+            "شوال",
+            "ذو القعدة",
+            "ذو الحجة",
+        ],
+        short: [
+            "محرم",
+            "صفر",
+            "ربيع ١",
+            "ربيع ٢",
+            "جمادى ١",
+            "جمادى ٢",
+            "رجب",
+            "شعبان",
+            "رمضان",
+            "شوال",
+            "ذو القعدة",
+            "ذو الحجة",
+        ],
+        narrow: ["م", "ص", "ر", "ر", "ج", "ج", "ر", "ش", "ر", "ش", "ذ", "ذ"],
+    },
+};
+const fallbackWeekdayNames = {
+    en: {
+        long: [
+            "Sunday",
+            "Monday",
+            "Tuesday",
+            "Wednesday",
+            "Thursday",
+            "Friday",
+            "Saturday",
+        ],
+        short: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
+        narrow: ["S", "M", "T", "W", "T", "F", "S"],
+    },
+    ar: {
+        long: [
+            "الأحد",
+            "الاثنين",
+            "الثلاثاء",
+            "الأربعاء",
+            "الخميس",
+            "الجمعة",
+            "السبت",
+        ],
+        short: ["أحد", "اثن", "ثلا", "أرب", "خمي", "جمع", "سبت"],
+        narrow: ["ح", "ن", "ث", "ر", "خ", "ج", "س"],
+    },
+};
+const getFallbackLocaleCode = (localeCode) => {
+    return localeCode.toLowerCase().startsWith("ar") ? "ar" : "en";
+};
+exports.getFallbackLocaleCode = getFallbackLocaleCode;
+const getFallbackMonthName = (date, localeCode, width) => {
+    const hijri = (0, conversion_js_1.toHijriDate)(date);
+    const locale = (0, exports.getFallbackLocaleCode)(localeCode);
+    return fallbackMonthNames[locale][width][hijri.monthIndex];
+};
+exports.getFallbackMonthName = getFallbackMonthName;
+const getFallbackWeekdayName = (date, localeCode, width) => {
+    const locale = (0, exports.getFallbackLocaleCode)(localeCode);
+    return fallbackWeekdayNames[locale][width][date.getDay()];
+};
+exports.getFallbackWeekdayName = getFallbackWeekdayName;

package/dist/cjs/hijri/lib/format.d.ts

@@ -0,0 +1,3 @@
+import type { FormatOptions as DateFnsFormatOptions } from "date-fns";
+/** Hijri calendar formatting override. */
+export declare function format(date: Date, formatStr: string, options?: DateFnsFormatOptions): string;