react-day-picker 9.13.2 → 10.0.0-next.0

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

@@ -0,0 +1,16 @@
+import { toDate } from "date-fns";
+import { toGregorianDate, toHijriDate } from "../utils/conversion.js";
+export function eachYearOfInterval(interval) {
+    const start = toDate(interval.start);
+    const end = toDate(interval.end);
+    if (end.getTime() < start.getTime()) {
+        return [];
+    }
+    const startYear = toHijriDate(start).year;
+    const endYear = toHijriDate(end).year;
+    const years = [];
+    for (let year = startYear; year <= endYear; year += 1) {
+        years.push(toGregorianDate({ year, monthIndex: 0, day: 1 }));
+    }
+    return years;
+}

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

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

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

@@ -0,0 +1,11 @@
+import { toGregorianDate, toHijriDate } from "../utils/conversion.js";
+import { getDaysInMonth } from "../utils/daysInMonth.js";
+export function endOfMonth(date) {
+    const hijri = toHijriDate(date);
+    const day = getDaysInMonth(hijri.year, hijri.monthIndex);
+    return toGregorianDate({
+        year: hijri.year,
+        monthIndex: hijri.monthIndex,
+        day,
+    });
+}

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

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

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

@@ -0,0 +1,11 @@
+import { toGregorianDate, toHijriDate } from "../utils/conversion.js";
+import { getDaysInMonth } from "../utils/daysInMonth.js";
+export function endOfYear(date) {
+    const hijri = toHijriDate(date);
+    const day = getDaysInMonth(hijri.year, 11);
+    return toGregorianDate({
+        year: hijri.year,
+        monthIndex: 11,
+        day,
+    });
+}

package/dist/esm/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/esm/hijri/lib/fallbackLocaleData.js

@@ -0,0 +1,105 @@
+import { toHijriDate } from "../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: ["ح", "ن", "ث", "ر", "خ", "ج", "س"],
+    },
+};
+export const getFallbackLocaleCode = (localeCode) => {
+    return localeCode.toLowerCase().startsWith("ar") ? "ar" : "en";
+};
+export const getFallbackMonthName = (date, localeCode, width) => {
+    const hijri = toHijriDate(date);
+    const locale = getFallbackLocaleCode(localeCode);
+    return fallbackMonthNames[locale][width][hijri.monthIndex];
+};
+export const getFallbackWeekdayName = (date, localeCode, width) => {
+    const locale = getFallbackLocaleCode(localeCode);
+    return fallbackWeekdayNames[locale][width][date.getDay()];
+};

package/dist/esm/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;

package/dist/esm/hijri/lib/format.js

@@ -0,0 +1,146 @@
+import { toHijriDate } from "../utils/conversion.js";
+import { clampGregorianDate, getGregorianDateParts } from "../utils/range.js";
+import { getFallbackMonthName, getFallbackWeekdayName, } from "./fallbackLocaleData.js";
+const DEFAULT_LOCALE_CODE = "ar-SA";
+const BASE_NUMBERING_SYSTEM = "latn";
+const UMM_AL_QURA_CALENDAR = "islamic-umalqura";
+const getLocaleCode = (options) => {
+    return options?.locale?.code ?? DEFAULT_LOCALE_CODE;
+};
+const formatWithUmmAlQura = (date, localeCode, options) => {
+    try {
+        return new Intl.DateTimeFormat(localeCode, {
+            ...options,
+            calendar: UMM_AL_QURA_CALENDAR,
+            numberingSystem: BASE_NUMBERING_SYSTEM,
+        }).format(date);
+    }
+    catch {
+        return undefined;
+    }
+};
+const formatNumber = (value) => {
+    return value.toString();
+};
+const formatPaddedNumber = (value) => {
+    return formatNumber(value).padStart(2, "0");
+};
+const formatMonthName = (date, localeCode, width) => {
+    const formatted = formatWithUmmAlQura(date, localeCode, {
+        month: width,
+    });
+    return formatted ?? getFallbackMonthName(date, localeCode, width);
+};
+const formatWeekdayName = (date, localeCode, width) => {
+    const formatted = formatWithUmmAlQura(date, localeCode, {
+        weekday: width,
+    });
+    return formatted ?? getFallbackWeekdayName(date, localeCode, width);
+};
+const formatDateStyle = (date, localeCode, style) => {
+    const formatted = formatWithUmmAlQura(date, localeCode, {
+        dateStyle: style,
+    });
+    if (formatted) {
+        return formatted;
+    }
+    const hijri = toHijriDate(date);
+    const monthName = getFallbackMonthName(date, localeCode, "long");
+    switch (style) {
+        case "full":
+            return `${getFallbackWeekdayName(date, localeCode, "long")}, ${monthName} ${hijri.day}, ${hijri.year}`;
+        case "long":
+            return `${monthName} ${hijri.day}, ${hijri.year}`;
+        case "medium":
+            return `${formatPaddedNumber(hijri.day)} ${monthName} ${hijri.year}`;
+        case "short":
+            return `${hijri.monthIndex + 1}/${hijri.day}/${hijri.year}`;
+    }
+};
+const buildTimeFormat = (date, localeCode, formatStr) => {
+    const hour12 = formatStr.includes("a");
+    const formatted = formatWithUmmAlQura(date, localeCode, {
+        hour: "numeric",
+        minute: "numeric",
+        hour12,
+    });
+    if (formatted) {
+        return formatted;
+    }
+    try {
+        return new Intl.DateTimeFormat(localeCode, {
+            hour: "numeric",
+            minute: "numeric",
+            hour12,
+            numberingSystem: BASE_NUMBERING_SYSTEM,
+        }).format(date);
+    }
+    catch {
+        const minutes = formatPaddedNumber(date.getMinutes());
+        if (hour12) {
+            const hour = date.getHours() % 12 || 12;
+            const period = date.getHours() >= 12 ? "PM" : "AM";
+            return `${hour}:${minutes} ${period}`;
+        }
+        return `${formatNumber(date.getHours())}:${minutes}`;
+    }
+};
+/** Hijri calendar formatting override. */
+export function format(date, formatStr, options) {
+    const extendedOptions = options;
+    const localeCode = getLocaleCode(extendedOptions);
+    const hijri = toHijriDate(date);
+    const gregorian = getGregorianDateParts(date);
+    const isOutOfRange = clampGregorianDate(date) !== date;
+    const numericDate = isOutOfRange
+        ? {
+            year: gregorian.year,
+            monthIndex: gregorian.month - 1,
+            day: gregorian.day,
+        }
+        : hijri;
+    switch (formatStr) {
+        case "LLLL y":
+        case "LLLL yyyy":
+            return `${formatMonthName(date, localeCode, "long")} ${formatNumber(numericDate.year)}`;
+        case "LLLL":
+            return formatMonthName(date, localeCode, "long");
+        case "LLL":
+            return formatMonthName(date, localeCode, "short");
+        case "PPP":
+            return formatDateStyle(date, localeCode, "long");
+        case "PPPP":
+            return formatDateStyle(date, localeCode, "full");
+        case "PP":
+            return formatDateStyle(date, localeCode, "medium");
+        case "P":
+            return formatDateStyle(date, localeCode, "short");
+        case "cccc":
+            return formatWeekdayName(date, localeCode, "long");
+        case "ccc":
+            return formatWeekdayName(date, localeCode, "short");
+        case "ccccc":
+        case "cccccc":
+            return formatWeekdayName(date, localeCode, "narrow");
+        case "yyyy":
+        case "y":
+            return formatNumber(numericDate.year);
+        case "yyyy-MM":
+            return `${formatNumber(numericDate.year)}-${formatPaddedNumber(numericDate.monthIndex + 1)}`;
+        case "yyyy-MM-dd":
+            return `${formatNumber(numericDate.year)}-${formatPaddedNumber(numericDate.monthIndex + 1)}-${formatPaddedNumber(numericDate.day)}`;
+        case "MM":
+            return formatPaddedNumber(numericDate.monthIndex + 1);
+        case "M":
+            return formatNumber(numericDate.monthIndex + 1);
+        case "dd":
+            return formatPaddedNumber(numericDate.day);
+        case "d":
+            return formatNumber(numericDate.day);
+        default:
+            if (/[Hh]/.test(formatStr) && /m/.test(formatStr)) {
+                return buildTimeFormat(date, localeCode, formatStr);
+            }
+            return formatDateStyle(date, localeCode, "medium");
+    }
+}

package/dist/esm/hijri/lib/getMonth.d.ts

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

package/dist/esm/hijri/lib/getMonth.js

@@ -0,0 +1,4 @@
+import { toHijriDate } from "../utils/conversion.js";
+export function getMonth(date) {
+    return toHijriDate(date).monthIndex;
+}

package/dist/esm/hijri/lib/getYear.d.ts

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

package/dist/esm/hijri/lib/getYear.js

@@ -0,0 +1,4 @@
+import { toHijriDate } from "../utils/conversion.js";
+export function getYear(date) {
+    return toHijriDate(date).year;
+}

package/dist/esm/hijri/lib/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./addMonths.js";
+export * from "./addYears.js";
+export * from "./differenceInCalendarMonths.js";
+export * from "./eachMonthOfInterval.js";
+export * from "./eachYearOfInterval.js";
+export * from "./endOfMonth.js";
+export * from "./endOfYear.js";
+export * from "./format.js";
+export * from "./getMonth.js";
+export * from "./getYear.js";
+export * from "./isSameMonth.js";
+export * from "./isSameYear.js";
+export * from "./newDate.js";
+export * from "./setMonth.js";
+export * from "./setYear.js";
+export * from "./startOfMonth.js";
+export * from "./startOfYear.js";

package/dist/esm/hijri/lib/index.js

@@ -0,0 +1,17 @@
+export * from "./addMonths.js";
+export * from "./addYears.js";
+export * from "./differenceInCalendarMonths.js";
+export * from "./eachMonthOfInterval.js";
+export * from "./eachYearOfInterval.js";
+export * from "./endOfMonth.js";
+export * from "./endOfYear.js";
+export * from "./format.js";
+export * from "./getMonth.js";
+export * from "./getYear.js";
+export * from "./isSameMonth.js";
+export * from "./isSameYear.js";
+export * from "./newDate.js";
+export * from "./setMonth.js";
+export * from "./setYear.js";
+export * from "./startOfMonth.js";
+export * from "./startOfYear.js";

package/dist/esm/hijri/lib/isSameMonth.d.ts

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

package/dist/esm/hijri/lib/isSameMonth.js

@@ -0,0 +1,7 @@
+import { toHijriDate } from "../utils/conversion.js";
+export function isSameMonth(dateLeft, dateRight) {
+    const hijriLeft = toHijriDate(dateLeft);
+    const hijriRight = toHijriDate(dateRight);
+    return (hijriLeft.year === hijriRight.year &&
+        hijriLeft.monthIndex === hijriRight.monthIndex);
+}

package/dist/esm/hijri/lib/isSameYear.d.ts

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

package/dist/esm/hijri/lib/isSameYear.js

@@ -0,0 +1,6 @@
+import { toHijriDate } from "../utils/conversion.js";
+export function isSameYear(dateLeft, dateRight) {
+    const hijriLeft = toHijriDate(dateLeft);
+    const hijriRight = toHijriDate(dateRight);
+    return hijriLeft.year === hijriRight.year;
+}

package/dist/esm/hijri/lib/newDate.d.ts

@@ -0,0 +1 @@
+export declare function newDate(year: number, monthIndex: number, day: number): Date;

package/dist/esm/hijri/lib/newDate.js

@@ -0,0 +1,4 @@
+import { toGregorianDate } from "../utils/conversion.js";
+export function newDate(year, monthIndex, day) {
+    return toGregorianDate({ year, monthIndex, day });
+}

package/dist/esm/hijri/lib/setMonth.d.ts

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

package/dist/esm/hijri/lib/setMonth.js

@@ -0,0 +1,24 @@
+import { toGregorianDate, toHijriDate } from "../utils/conversion.js";
+import { getDaysInMonth } from "../utils/daysInMonth.js";
+export function setMonth(date, monthIndex) {
+    const hijri = toHijriDate(date);
+    // Handle overflow/underflow of monthIndex
+    // Note: monthIndex argument is absolute month index for the year.
+    // E.g. setMonth(..., 13) sets to Safar next year.
+    let targetYear = hijri.year;
+    let targetMonth = monthIndex;
+    if (targetMonth > 11 || targetMonth < 0) {
+        targetYear += Math.floor(targetMonth / 12);
+        targetMonth = targetMonth % 12;
+        if (targetMonth < 0) {
+            targetMonth += 12;
+        }
+    }
+    const daysInTargetMonth = getDaysInMonth(targetYear, targetMonth);
+    const day = Math.min(hijri.day, daysInTargetMonth);
+    return toGregorianDate({
+        year: targetYear,
+        monthIndex: targetMonth,
+        day,
+    });
+}

package/dist/esm/hijri/lib/setYear.d.ts

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

package/dist/esm/hijri/lib/setYear.js

@@ -0,0 +1,12 @@
+import { toGregorianDate, toHijriDate } from "../utils/conversion.js";
+import { getDaysInMonth } from "../utils/daysInMonth.js";
+export function setYear(date, year) {
+    const hijri = toHijriDate(date);
+    const daysInTargetMonth = getDaysInMonth(year, hijri.monthIndex);
+    const day = Math.min(hijri.day, daysInTargetMonth);
+    return toGregorianDate({
+        year,
+        monthIndex: hijri.monthIndex,
+        day,
+    });
+}

package/dist/esm/hijri/lib/startOfMonth.d.ts

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

package/dist/esm/hijri/lib/startOfMonth.js

@@ -0,0 +1,9 @@
+import { toGregorianDate, toHijriDate } from "../utils/conversion.js";
+export function startOfMonth(date) {
+    const hijri = toHijriDate(date);
+    return toGregorianDate({
+        year: hijri.year,
+        monthIndex: hijri.monthIndex,
+        day: 1,
+    });
+}

package/dist/esm/hijri/lib/startOfYear.d.ts

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

package/dist/esm/hijri/lib/startOfYear.js

@@ -0,0 +1,9 @@
+import { toGregorianDate, toHijriDate } from "../utils/conversion.js";
+export function startOfYear(date) {
+    const hijri = toHijriDate(date);
+    return toGregorianDate({
+        year: hijri.year,
+        monthIndex: 0,
+        day: 1,
+    });
+}

package/dist/esm/hijri/utils/conversion.d.ts

@@ -0,0 +1,5 @@
+import type { HijriDate } from "./types.js";
+/** Convert a Gregorian date to a Hijri date. */
+export declare function toHijriDate(date: Date): HijriDate;
+/** Convert a Hijri date back to the Gregorian calendar. */
+export declare function toGregorianDate(hijri: HijriDate): Date;

package/dist/esm/hijri/utils/conversion.js

@@ -0,0 +1,36 @@
+import { gregorianToHijri, hijriToGregorian } from "@tabby_ai/hijri-converter";
+import { clampGregorianDate, clampHijriDate, GREGORIAN_MIN_DATE, getGregorianDateParts, } from "./range.js";
+/** Convert a Gregorian date to a Hijri date. */
+export function toHijriDate(date) {
+    const clamped = clampGregorianDate(date);
+    const { year, month, day } = getGregorianDateParts(clamped);
+    // gregorianToHijri uses 1-indexed months
+    const hijri = gregorianToHijri({ year, month, day });
+    return {
+        year: hijri.year,
+        monthIndex: hijri.month - 1, // Convert to 0-indexed
+        day: hijri.day,
+    };
+}
+/** Convert a Hijri date back to the Gregorian calendar. */
+export function toGregorianDate(hijri) {
+    const clamped = clampHijriDate(hijri);
+    // hijriToGregorian expects 1-indexed months. Probe down from the candidate
+    // day to handle invalid month/day combinations without throwing.
+    for (let day = clamped.day; day >= 1; day -= 1) {
+        try {
+            const gregorian = hijriToGregorian({
+                year: clamped.year,
+                month: clamped.monthIndex + 1,
+                day,
+            });
+            return clampGregorianDate(new Date(gregorian.year, gregorian.month - 1, gregorian.day));
+        }
+        catch {
+            // Try a lower day for months that only have 29 days.
+        }
+    }
+    // Fallback to the minimum supported Gregorian date if conversion probing
+    // somehow fails for all days.
+    return new Date(GREGORIAN_MIN_DATE);
+}

package/dist/esm/hijri/utils/daysInMonth.d.ts

@@ -0,0 +1 @@
+export declare function getDaysInMonth(year: number, monthIndex: number): number;

package/dist/esm/hijri/utils/daysInMonth.js

@@ -0,0 +1,21 @@
+import { toGregorianDate, toHijriDate } from "./conversion.js";
+import { clampHijriDate } from "./range.js";
+const MAX_DAY_IN_HIJRI_MONTH = 30;
+const MIN_DAY_IN_HIJRI_MONTH = 29;
+export function getDaysInMonth(year, monthIndex) {
+    const clamped = clampHijriDate({ year, monthIndex, day: 1 });
+    for (let day = MAX_DAY_IN_HIJRI_MONTH; day >= MIN_DAY_IN_HIJRI_MONTH; day -= 1) {
+        const candidateDate = toGregorianDate({
+            year: clamped.year,
+            monthIndex: clamped.monthIndex,
+            day,
+        });
+        const roundTrip = toHijriDate(candidateDate);
+        if (roundTrip.year === clamped.year &&
+            roundTrip.monthIndex === clamped.monthIndex &&
+            roundTrip.day === day) {
+            return day;
+        }
+    }
+    return MIN_DAY_IN_HIJRI_MONTH;
+}

package/dist/esm/hijri/utils/range.d.ts

@@ -0,0 +1,21 @@
+import type { HijriDate } from "./types.js";
+type GregorianDateParts = {
+    year: number;
+    month: number;
+    day: number;
+};
+/** Returns Gregorian date parts while preserving years < 100. */
+export declare function getGregorianDateParts(date: Date): GregorianDateParts;
+/** Internal Gregorian lower bound supported by the Hijri converter. */
+export declare const GREGORIAN_MIN_DATE: Date;
+/** Internal Gregorian upper bound supported by the Hijri converter. */
+export declare const GREGORIAN_MAX_DATE: Date;
+/** Clamp a Gregorian date to the supported Hijri conversion range. */
+export declare function clampGregorianDate(date: Date): Date;
+/** Returns whether the provided Gregorian date was clamped. */
+export declare function wasGregorianDateClamped(date: Date): boolean;
+/** Clamp a Hijri date to the supported range and normalize month overflow. */
+export declare function clampHijriDate(date: HijriDate): HijriDate;
+/** Returns whether the provided Hijri date was clamped. */
+export declare function wasHijriDateClamped(date: HijriDate): boolean;
+export {};

package/dist/esm/hijri/utils/range.js

@@ -0,0 +1,96 @@
+const MAX_HIJRI_DAY = 30;
+const MONTHS_PER_YEAR = 12;
+const HIJRI_MIN = { year: 1343, monthIndex: 0, day: 1 };
+const HIJRI_MAX = { year: 1500, monthIndex: 11, day: 30 };
+const GREGORIAN_MIN = { year: 1924, month: 8, day: 1 };
+const GREGORIAN_MAX = { year: 2077, month: 11, day: 16 };
+function compareGregorianDates(left, right) {
+    if (left.year !== right.year) {
+        return left.year - right.year;
+    }
+    if (left.month !== right.month) {
+        return left.month - right.month;
+    }
+    return left.day - right.day;
+}
+function createDate(parts) {
+    return new Date(parts.year, parts.month - 1, parts.day);
+}
+function normalizeHijriMonth(year, monthIndex) {
+    let normalizedYear = year + Math.trunc(monthIndex / MONTHS_PER_YEAR);
+    let normalizedMonth = monthIndex % MONTHS_PER_YEAR;
+    if (normalizedMonth < 0) {
+        normalizedMonth += MONTHS_PER_YEAR;
+        normalizedYear -= 1;
+    }
+    return { year: normalizedYear, monthIndex: normalizedMonth };
+}
+/** Returns Gregorian date parts while preserving years < 100. */
+export function getGregorianDateParts(date) {
+    const useUTC = date.getFullYear() < 100;
+    return {
+        year: useUTC ? date.getUTCFullYear() : date.getFullYear(),
+        month: (useUTC ? date.getUTCMonth() : date.getMonth()) + 1,
+        day: useUTC ? date.getUTCDate() : date.getDate(),
+    };
+}
+/** Internal Gregorian lower bound supported by the Hijri converter. */
+export const GREGORIAN_MIN_DATE = createDate(GREGORIAN_MIN);
+/** Internal Gregorian upper bound supported by the Hijri converter. */
+export const GREGORIAN_MAX_DATE = createDate(GREGORIAN_MAX);
+/** Clamp a Gregorian date to the supported Hijri conversion range. */
+export function clampGregorianDate(date) {
+    const parts = getGregorianDateParts(date);
+    if (compareGregorianDates(parts, GREGORIAN_MIN) < 0) {
+        return createDate(GREGORIAN_MIN);
+    }
+    if (compareGregorianDates(parts, GREGORIAN_MAX) > 0) {
+        return createDate(GREGORIAN_MAX);
+    }
+    return date;
+}
+/** Returns whether the provided Gregorian date was clamped. */
+export function wasGregorianDateClamped(date) {
+    return clampGregorianDate(date) !== date;
+}
+/** Clamp a Hijri date to the supported range and normalize month overflow. */
+export function clampHijriDate(date) {
+    const normalized = normalizeHijriMonth(date.year, date.monthIndex);
+    const candidate = {
+        year: normalized.year,
+        monthIndex: normalized.monthIndex,
+        day: Math.min(Math.max(date.day, 1), MAX_HIJRI_DAY),
+    };
+    if (candidate.year < HIJRI_MIN.year) {
+        return { ...HIJRI_MIN };
+    }
+    if (candidate.year > HIJRI_MAX.year) {
+        return { ...HIJRI_MAX };
+    }
+    if (candidate.year === HIJRI_MIN.year &&
+        candidate.monthIndex < HIJRI_MIN.monthIndex) {
+        return { ...HIJRI_MIN };
+    }
+    if (candidate.year === HIJRI_MAX.year &&
+        candidate.monthIndex > HIJRI_MAX.monthIndex) {
+        return { ...HIJRI_MAX };
+    }
+    if (candidate.year === HIJRI_MIN.year &&
+        candidate.monthIndex === HIJRI_MIN.monthIndex &&
+        candidate.day < HIJRI_MIN.day) {
+        return { ...HIJRI_MIN };
+    }
+    if (candidate.year === HIJRI_MAX.year &&
+        candidate.monthIndex === HIJRI_MAX.monthIndex &&
+        candidate.day > HIJRI_MAX.day) {
+        return { ...HIJRI_MAX };
+    }
+    return candidate;
+}
+/** Returns whether the provided Hijri date was clamped. */
+export function wasHijriDateClamped(date) {
+    const clamped = clampHijriDate(date);
+    return (clamped.year !== date.year ||
+        clamped.monthIndex !== date.monthIndex ||
+        clamped.day !== date.day);
+}