react-day-picker 9.9.0 → 9.10.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](https://daypicker.dev/docs/localization#iso-week-dates), [Persian](https://daypicker.dev/docs/localization#persian-calendar), and [broadcast](https://daypicker.dev/docs/localization#broadcast-calendar) calendar.
+- 🌐 Support for [ISO 8601](https://daypicker.dev/docs/localization#iso-week-dates), [Persian](https://daypicker.dev/docs/localization#persian-calendar), [Ethiopic](https://daypicker.dev/docs/localization#ethiopic-calendar) and [broadcast](https://daypicker.dev/docs/localization#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).
@@ -70,8 +70,27 @@ Ask for help and share your experience with DayPicker:
 - 💬 [Discussion forums](https://github.com/gpbl/react-day-picker/discussions) - Get support and provide feedback.
 - 🪳 [Report an issue](https://github.com/gpbl/react-day-picker/issues/new/choose) - Report bugs or request features.
 
-## Funding
-
-Consider supporting DayPicker's maintainer with a donation. Your support helps keep the project alive and up-to-date.
-
-- 🎗️ [Sponsor DayPicker on GitHub](https://github.com/sponsors/gpbl)
+## Sponsors
+
+Thank you to everyone supporting DayPicker - your sponsorship keeps this project maintained and evolving.
+
+<p>
+  <a href="https://github.com/CHECK24" title="CHECK24"><img src="https://github.com/CHECK24.png?size=64" alt="CHECK24" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/oluwatunmiisheii" title="oluwatunmiisheii"><img src="https://github.com/oluwatunmiisheii.png?size=64" alt="oluwatunmiisheii" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/severinlandolt" title="severinlandolt"><img src="https://github.com/severinlandolt.png?size=64" alt="severinlandolt" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/syntaxfm" title="syntaxfm"><img src="https://github.com/syntaxfm.png?size=64" alt="syntaxfm" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/thnxdev" title="thnxdev"><img src="https://github.com/thnxdev.png?size=64" alt="thnxdev" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/katyabilokur" title="katyabilokur"><img src="https://github.com/katyabilokur.png?size=64" alt="katyabilokur" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/bedandbreakfasteu" title="bedandbreakfasteu"><img src="https://github.com/bedandbreakfasteu.png?size=64" alt="bedandbreakfasteu" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/codecov" title="codecov"><img src="https://github.com/codecov.png?size=64" alt="codecov" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/manavm1990" title="manavm1990"><img src="https://github.com/manavm1990.png?size=64" alt="manavm1990" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/Thinkmill" title="Thinkmill"><img src="https://github.com/Thinkmill.png?size=64" alt="Thinkmill" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/AlexKDawson" title="AlexKDawson"><img src="https://github.com/AlexKDawson.png?size=64" alt="AlexKDawson" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/dimitur2204" title="dimitur2204"><img src="https://github.com/dimitur2204.png?size=64" alt="dimitur2204" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/indeedeng" title="indeedeng"><img src="https://github.com/indeedeng.png?size=64" alt="indeedeng" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/flexbox" title="flexbox"><img src="https://github.com/flexbox.png?size=64" alt="flexbox" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/github" title="github"><img src="https://github.com/github.png?size=64" alt="github" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+  <a href="https://github.com/tjfred35" title="tjfred35"><img src="https://github.com/tjfred35.png?size=64" alt="tjfred35" width="48" height="48" style="border-radius:50%; margin: 4px;" /></a>
+</p>
+
+- 🎗️ Become a sponsor: https://github.com/sponsors/gpbl

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

@@ -0,0 +1,42 @@
+import type { Locale } from "date-fns";
+import React from "react";
+import { DateLib, type DateLibOptions } from "../index.js";
+import type { DayPickerProps } from "../types/props.js";
+export { enUS } from "date-fns/locale/en-US";
+/**
+ * Render the Ethiopic calendar.
+ *
+ * Defaults:
+ * - `locale`: `am-ET` (Amharic) via an Intl-backed date-fns locale
+ * - `numerals`: `geez` (Ethiopic digits)
+ *
+ * Notes:
+ * - Weekday names are taken from `Intl.DateTimeFormat(locale.code)`.
+ * - Month names are Amharic by default; they switch to Latin transliteration
+ *   when `locale.code` starts with `en` or when `numerals` is `latn`.
+ * - Time tokens like `hh:mm a` are formatted via `Intl.DateTimeFormat` using
+ *   the provided `locale`.
+ *
+ * @see https://daypicker.dev/docs/localization#ethiopic-calendar
+ */
+export declare function DayPicker(props: DayPickerProps & {
+    /**
+     * The locale to use in the calendar.
+     *
+     * @default `am-ET`
+     */
+    locale?: Locale;
+    /**
+     * The numeral system to use when formatting dates.
+     *
+     * - `latn`: Latin (Western Arabic)
+     * - `geez`: Ge'ez (Ethiopic numerals)
+     *
+     * @defaultValue `geez` (Ethiopic numerals)
+     * @see https://daypicker.dev/docs/translation#numeral-systems
+     */
+    numerals?: DayPickerProps["numerals"];
+}): React.JSX.Element;
+/** Returns the date library used in the calendar. */
+export declare const getDateLib: (options?: DateLibOptions) => DateLib;
+export { amET } from "./locale/am-ET.js";

package/dist/cjs/ethiopic/index.js

@@ -0,0 +1,75 @@
+"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.amET = exports.getDateLib = exports.enUS = void 0;
+exports.DayPicker = DayPicker;
+const react_1 = __importDefault(require("react"));
+const index_js_1 = require("../index.js");
+const ethiopicDateLib = __importStar(require("./lib/index.js"));
+const am_ET_js_1 = __importDefault(require("./locale/am-ET.js"));
+var en_US_1 = require("date-fns/locale/en-US");
+Object.defineProperty(exports, "enUS", { enumerable: true, get: function () { return en_US_1.enUS; } });
+/**
+ * Render the Ethiopic calendar.
+ *
+ * Defaults:
+ * - `locale`: `am-ET` (Amharic) via an Intl-backed date-fns locale
+ * - `numerals`: `geez` (Ethiopic digits)
+ *
+ * Notes:
+ * - Weekday names are taken from `Intl.DateTimeFormat(locale.code)`.
+ * - Month names are Amharic by default; they switch to Latin transliteration
+ *   when `locale.code` starts with `en` or when `numerals` is `latn`.
+ * - Time tokens like `hh:mm a` are formatted via `Intl.DateTimeFormat` using
+ *   the provided `locale`.
+ *
+ * @see https://daypicker.dev/docs/localization#ethiopic-calendar
+ */
+function DayPicker(props) {
+    return (react_1.default.createElement(index_js_1.DayPicker, { ...props, locale: props.locale ?? am_ET_js_1.default, numerals: props.numerals ?? "geez", 
+        // Pass overrides, not a DateLib instance
+        dateLib: ethiopicDateLib }));
+}
+/** Returns the date library used in the calendar. */
+const getDateLib = (options) => {
+    return new index_js_1.DateLib(options, ethiopicDateLib);
+};
+exports.getDateLib = getDateLib;
+// Export a minimal Amharic (Ethiopia) date-fns locale that uses Intl
+var am_ET_js_2 = require("./locale/am-ET.js");
+Object.defineProperty(exports, "amET", { enumerable: true, get: function () { return am_ET_js_2.amET; } });

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

@@ -0,0 +1,9 @@
+/**
+ * Adds the specified number of months to the given Ethiopian date. Handles
+ * month overflow and year boundaries correctly.
+ *
+ * @param date - The starting gregorian date
+ * @param amount - The number of months to add (can be negative)
+ * @returns A new gregorian date with the months added
+ */
+export declare function addMonths(date: Date, amount: number): Date;

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addMonths = addMonths;
+const daysInMonth_js_1 = require("../utils/daysInMonth.js");
+const index_js_1 = require("../utils/index.js");
+/**
+ * Adds the specified number of months to the given Ethiopian date. Handles
+ * month overflow and year boundaries correctly.
+ *
+ * @param date - The starting gregorian date
+ * @param amount - The number of months to add (can be negative)
+ * @returns A new gregorian date with the months added
+ */
+function addMonths(date, amount) {
+    const { year, month, day } = (0, index_js_1.toEthiopicDate)(date);
+    let newMonth = month + amount;
+    const yearAdjustment = Math.floor((newMonth - 1) / 13);
+    newMonth = ((newMonth - 1) % 13) + 1;
+    if (newMonth < 1) {
+        newMonth += 13;
+    }
+    const newYear = year + yearAdjustment;
+    // Adjust day if it exceeds the month length
+    const monthLength = (0, daysInMonth_js_1.daysInMonth)(newMonth, newYear);
+    const newDay = Math.min(day, monthLength);
+    return (0, index_js_1.toGregorianDate)({ year: newYear, month: newMonth, day: newDay });
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Adds the specified number of years to the given Ethiopian date. Handles leap
+ * year transitions for Pagume month.
+ *
+ * @param date - The starting gregorian date
+ * @param amount - The number of years to add (can be negative)
+ * @returns A new gregorian date with the years added
+ */
+export declare function addYears(date: Date, amount: number): Date;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addYears = addYears;
+const index_js_1 = require("../utils/index.js");
+/**
+ * Adds the specified number of years to the given Ethiopian date. Handles leap
+ * year transitions for Pagume month.
+ *
+ * @param date - The starting gregorian date
+ * @param amount - The number of years to add (can be negative)
+ * @returns A new gregorian date with the years added
+ */
+function addYears(date, amount) {
+    const etDate = (0, index_js_1.toEthiopicDate)(date);
+    const day = (0, index_js_1.isEthiopicLeapYear)(etDate.year) &&
+        etDate.month === 13 &&
+        etDate.day === 6 &&
+        amount % 4 !== 0
+        ? 5
+        : etDate.day;
+    return (0, index_js_1.toGregorianDate)({
+        month: etDate.month,
+        day: day,
+        year: etDate.year + amount,
+    });
+}

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

@@ -0,0 +1,8 @@
+/**
+ * Difference in calendar months
+ *
+ * @param {Date} dateLeft - The later date
+ * @param {Date} dateRight - The earlier date
+ * @returns {number} The number of calendar months between the two dates
+ */
+export declare function differenceInCalendarMonths(dateLeft: Date, dateRight: Date): number;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.differenceInCalendarMonths = differenceInCalendarMonths;
+const index_js_1 = require("../utils/index.js");
+/**
+ * Difference in calendar months
+ *
+ * @param {Date} dateLeft - The later date
+ * @param {Date} dateRight - The earlier date
+ * @returns {number} The number of calendar months between the two dates
+ */
+function differenceInCalendarMonths(dateLeft, dateRight) {
+    const ethiopicLeft = (0, index_js_1.toEthiopicDate)(dateLeft);
+    const ethiopicRight = (0, index_js_1.toEthiopicDate)(dateRight);
+    return ((ethiopicLeft.year - ethiopicRight.year) * 13 +
+        (ethiopicLeft.month - ethiopicRight.month));
+}

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

@@ -0,0 +1,11 @@
+import type { Interval } from "date-fns";
+/**
+ * Each month of an interval
+ *
+ * @param {Object} interval - The interval object
+ * @param {Date} interval.start - The start date of the interval
+ * @param {Date} interval.end - The end date of the interval
+ * @returns {Date[]} An array of dates representing the start of each month in
+ *   the interval
+ */
+export declare function eachMonthOfInterval(interval: Interval): Date[];

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eachMonthOfInterval = eachMonthOfInterval;
+const index_js_1 = require("../utils/index.js");
+/**
+ * Each month of an interval
+ *
+ * @param {Object} interval - The interval object
+ * @param {Date} interval.start - The start date of the interval
+ * @param {Date} interval.end - The end date of the interval
+ * @returns {Date[]} An array of dates representing the start of each month in
+ *   the interval
+ */
+function eachMonthOfInterval(interval) {
+    const start = (0, index_js_1.toEthiopicDate)(new Date(interval.start));
+    const end = (0, index_js_1.toEthiopicDate)(new Date(interval.end));
+    const dates = [];
+    let currentYear = start.year;
+    let currentMonth = start.month;
+    while (currentYear < end.year ||
+        (currentYear === end.year && currentMonth <= end.month)) {
+        dates.push((0, index_js_1.toGregorianDate)({ year: currentYear, month: currentMonth, day: 1 }));
+        currentMonth++;
+        if (currentMonth > 13) {
+            currentMonth = 1;
+            currentYear++;
+        }
+    }
+    return dates;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * Returns the last day of the Ethiopian month for the given date.
+ *
+ * @param date - The gregorian date to get the end of month for
+ * @returns A new gregorian date representing the last day of the Ethiopian
+ *   month
+ */
+export declare function endOfMonth(date: Date): Date;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endOfMonth = endOfMonth;
+const daysInMonth_js_1 = require("../utils/daysInMonth.js");
+const index_js_1 = require("../utils/index.js");
+/**
+ * Returns the last day of the Ethiopian month for the given date.
+ *
+ * @param date - The gregorian date to get the end of month for
+ * @returns A new gregorian date representing the last day of the Ethiopian
+ *   month
+ */
+function endOfMonth(date) {
+    const { year, month } = (0, index_js_1.toEthiopicDate)(date);
+    const day = (0, daysInMonth_js_1.daysInMonth)(month, year);
+    return (0, index_js_1.toGregorianDate)({ year, month, day: day });
+}

package/dist/cjs/ethiopic/lib/endOfWeek.d.ts

@@ -0,0 +1,9 @@
+import { type EndOfWeekOptions } from "date-fns";
+/**
+ * End of week
+ *
+ * @param {Date} date - The original date
+ * @param {EndOfWeekOptions} [options] - The options object
+ * @returns {Date} The end of the week
+ */
+export declare function endOfWeek(date: Date, options?: EndOfWeekOptions): Date;

package/dist/cjs/ethiopic/lib/endOfWeek.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endOfWeek = endOfWeek;
+const date_fns_1 = require("date-fns");
+/**
+ * End of week
+ *
+ * @param {Date} date - The original date
+ * @param {EndOfWeekOptions} [options] - The options object
+ * @returns {Date} The end of the week
+ */
+function endOfWeek(date, options) {
+    const weekStartsOn = options?.weekStartsOn ?? 0; // Default to Monday (1)
+    const endOfWeek = (0, date_fns_1.endOfWeek)(date, { weekStartsOn });
+    return endOfWeek;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * End of year
+ *
+ * @param {Date} date - The original date
+ * @returns {Date} The end of the year
+ */
+export declare function endOfYear(date: Date): Date;

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endOfYear = endOfYear;
+const index_js_1 = require("../utils/index.js");
+/**
+ * End of year
+ *
+ * @param {Date} date - The original date
+ * @returns {Date} The end of the year
+ */
+function endOfYear(date) {
+    const { year } = (0, index_js_1.toEthiopicDate)(date);
+    const day = (0, index_js_1.isEthiopicLeapYear)(year) ? 6 : 5;
+    return (0, index_js_1.toGregorianDate)({ year, month: 13, day });
+}

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

@@ -0,0 +1,21 @@
+import type { FormatOptions as DateFnsFormatOptions } from "date-fns";
+/** Options for formatting dates in the Ethiopian calendar */
+export type FormatOptions = DateFnsFormatOptions;
+/**
+ * Format an Ethiopic calendar date using a subset of date-fns tokens.
+ *
+ * Behavior specifics for Ethiopic mode:
+ * - Weekday names ("cccc", "cccccc") come from `Intl.DateTimeFormat` using
+ *   `options.locale?.code` (default: `am-ET`). Narrow form is a single letter.
+ * - Month names ("LLLL") are Amharic by default and switch to Latin
+ *   transliteration when the locale code starts with `en` or when
+ *   `options.numerals === 'latn'`.
+ * - Time parts such as `hh:mm a` are delegated to `Intl.DateTimeFormat` with
+ *   the given locale.
+ * - Digits are converted to Ethiopic (Geez) when `options.numerals === 'geez'`.
+ */
+export declare function format(date: Date, formatStr: string, options?: DateFnsFormatOptions): string;
+export declare const ethMonths: string[];
+export declare const ethMonthsLatin: string[];
+export declare const shortDays: string[];
+export declare const longDays: string[];

package/dist/cjs/ethiopic/lib/format.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.longDays = exports.shortDays = exports.ethMonthsLatin = exports.ethMonths = void 0;
+exports.format = format;
+const index_js_1 = require("../utils/index.js");
+const formatNumber_js_1 = require("./formatNumber.js");
+function getEtDayName(day, short = true, localeCode = "am-ET") {
+    try {
+        const dtf = new Intl.DateTimeFormat(localeCode, {
+            // Ethiopic calendar expects single-letter for "cccccc" -> use narrow
+            weekday: short ? "narrow" : "long",
+        });
+        return dtf.format(day);
+    }
+    catch {
+        const dayOfWeek = day.getDay();
+        return short ? exports.shortDays[dayOfWeek] : exports.longDays[dayOfWeek];
+    }
+}
+function getEtMonthName(m, latin = false) {
+    if (m > 0 && m <= 13) {
+        return latin ? exports.ethMonthsLatin[m - 1] : exports.ethMonths[m - 1];
+    }
+    return "";
+}
+function formatEthiopianDate(dateObj, formatStr, numerals, localeCode) {
+    const etDate = dateObj ? (0, index_js_1.toEthiopicDate)(dateObj) : undefined;
+    if (!etDate)
+        return "";
+    const useLatin = (localeCode?.startsWith("en") ?? false) || numerals === "latn";
+    switch (formatStr) {
+        case "LLLL yyyy":
+        case "LLLL y":
+            return `${getEtMonthName(etDate.month, useLatin)} ${etDate.year}`;
+        case "LLLL":
+            return getEtMonthName(etDate.month, useLatin);
+        case "yyyy-MM-dd":
+            return `${etDate.year}-${etDate.month
+                .toString()
+                .padStart(2, "0")}-${etDate.day.toString().padStart(2, "0")}`;
+        case "yyyy-MM":
+            return `${etDate.year}-${etDate.month.toString().padStart(2, "0")}`;
+        case "d":
+            return etDate.day.toString();
+        case "PPP":
+            return ` ${getEtMonthName(etDate.month, useLatin)} ${etDate.day}, ${etDate.year}`;
+        case "PPPP":
+            if (!dateObj)
+                return "";
+            return `${getEtDayName(dateObj, false, localeCode)}, ${getEtMonthName(etDate.month, useLatin)} ${etDate.day}, ${etDate.year}`;
+        case "cccc":
+            return dateObj ? getEtDayName(dateObj, false, localeCode) : "";
+        case "cccccc":
+            return dateObj ? getEtDayName(dateObj, true, localeCode) : "";
+        default:
+            return `${etDate.day}/${etDate.month}/${etDate.year}`;
+    }
+}
+/**
+ * Format an Ethiopic calendar date using a subset of date-fns tokens.
+ *
+ * Behavior specifics for Ethiopic mode:
+ * - Weekday names ("cccc", "cccccc") come from `Intl.DateTimeFormat` using
+ *   `options.locale?.code` (default: `am-ET`). Narrow form is a single letter.
+ * - Month names ("LLLL") are Amharic by default and switch to Latin
+ *   transliteration when the locale code starts with `en` or when
+ *   `options.numerals === 'latn'`.
+ * - Time parts such as `hh:mm a` are delegated to `Intl.DateTimeFormat` with
+ *   the given locale.
+ * - Digits are converted to Ethiopic (Geez) when `options.numerals === 'geez'`.
+ */
+function format(date, formatStr, options) {
+    const extendedOptions = options;
+    if (formatStr.includes("hh:mm") || formatStr.includes("a")) {
+        return new Intl.DateTimeFormat(extendedOptions?.locale?.code ?? "en-US", {
+            hour: "numeric",
+            minute: "numeric",
+            hour12: formatStr.includes("a"),
+        }).format(date);
+    }
+    const formatted = formatEthiopianDate(date, formatStr, extendedOptions?.numerals, extendedOptions?.locale?.code ?? "am-ET");
+    if (extendedOptions?.numerals && extendedOptions.numerals === "geez") {
+        return formatted.replace(/\d+/g, (match) => (0, formatNumber_js_1.formatNumber)(parseInt(match), "geez"));
+    }
+    return formatted;
+}
+exports.ethMonths = [
+    "መስከረም",
+    "ጥቅምት",
+    "ህዳር",
+    "ታህሳስ",
+    "ጥር",
+    "የካቲት",
+    "መጋቢት",
+    "ሚያዚያ",
+    "ግንቦት",
+    "ሰኔ",
+    "ሐምሌ",
+    "ነሀሴ",
+    "ጳጉሜ",
+];
+exports.ethMonthsLatin = [
+    "Meskerem",
+    "Tikimt",
+    "Hidar",
+    "Tahsas",
+    "Tir",
+    "Yekatit",
+    "Megabit",
+    "Miyazya",
+    "Ginbot",
+    "Sene",
+    "Hamle",
+    "Nehase",
+    "Pagumen",
+];
+exports.shortDays = ["እ", "ሰ", "ማ", "ረ", "ሐ", "ዓ", "ቅ"];
+exports.longDays = ["እሁድ", "ሰኞ", "ማክሰኞ", "ረቡዕ", "ሐሙስ", "ዓርብ", "ቅዳሜ"];

package/dist/cjs/ethiopic/lib/formatNumber.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Formats a number using either Latin or Ethiopic (Geez) numerals
+ *
+ * @example
+ *   ```ts
+ *   formatNumber(123) // '123'
+ *   formatNumber(123, 'geez') // '፻፳፫'
+ *   formatNumber(2023, 'geez') // '፳፻፳፫'
+ *   ```;
+ *
+ * @param value - The number to format
+ * @param numerals - The numeral system to use:
+ *
+ *   - 'latn': Latin numerals (1, 2, 3...)
+ *   - 'geez': Ethiopic numerals (፩, ፪, ፫...)
+ *
+ * @returns The formatted number string
+ */
+export declare function formatNumber(value: number, numerals?: string): string;

package/dist/cjs/ethiopic/lib/formatNumber.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatNumber = formatNumber;
+const toGeezNumerals_js_1 = require("../utils/toGeezNumerals.js");
+/**
+ * Formats a number using either Latin or Ethiopic (Geez) numerals
+ *
+ * @example
+ *   ```ts
+ *   formatNumber(123) // '123'
+ *   formatNumber(123, 'geez') // '፻፳፫'
+ *   formatNumber(2023, 'geez') // '፳፻፳፫'
+ *   ```;
+ *
+ * @param value - The number to format
+ * @param numerals - The numeral system to use:
+ *
+ *   - 'latn': Latin numerals (1, 2, 3...)
+ *   - 'geez': Ethiopic numerals (፩, ፪, ፫...)
+ *
+ * @returns The formatted number string
+ */
+function formatNumber(value, numerals = "latn") {
+    if (numerals === "geez") {
+        return (0, toGeezNumerals_js_1.toGeezNumerals)(value);
+    }
+    // Use Intl.NumberFormat for other numeral systems
+    const formatter = new Intl.NumberFormat("en-US", {
+        numberingSystem: numerals,
+    });
+    return formatter.format(value);
+}

package/dist/cjs/ethiopic/lib/getMonth.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Get month
+ *
+ * @param {Date} date - The original date
+ * @returns {number} The zero-based month index
+ */
+export declare function getMonth(date: Date): number;

package/dist/cjs/ethiopic/lib/getMonth.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMonth = getMonth;
+const index_js_1 = require("../utils/index.js");
+/**
+ * Get month
+ *
+ * @param {Date} date - The original date
+ * @returns {number} The zero-based month index
+ */
+function getMonth(date) {
+    const { month } = (0, index_js_1.toEthiopicDate)(date);
+    return month - 1; // Return zero-based month index
+}

package/dist/cjs/ethiopic/lib/getWeek.d.ts

@@ -0,0 +1,9 @@
+import { type GetWeekOptions } from "date-fns";
+/**
+ * Get week number for Ethiopian calendar
+ *
+ * @param {Date} date - The original date
+ * @param {GetWeekOptions} [options] - The options object
+ * @returns {number} The week number
+ */
+export declare function getWeek(date: Date, options?: GetWeekOptions): number;