@sonill/nepali-dates 0.1.0

package/dist/index.js

@@ -0,0 +1,682 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BASE_AD_DATE: () => BASE_AD_DATE,
+  BASE_BS_DATE: () => BASE_BS_DATE,
+  ENGLISH_MONTH_NAMES: () => ENGLISH_MONTH_NAMES,
+  MAX_YEAR: () => MAX_YEAR,
+  MIN_YEAR: () => MIN_YEAR,
+  NEPALI_CALENDAR_DATA: () => NEPALI_CALENDAR_DATA,
+  NEPALI_MONTH_NAMES_EN: () => NEPALI_MONTH_NAMES_EN,
+  NEPALI_MONTH_NAMES_NE: () => NEPALI_MONTH_NAMES_NE,
+  NepaliMonth: () => NepaliMonth,
+  REFERENCE_DATES: () => REFERENCE_DATES,
+  adToBs: () => adToBs,
+  bsToAd: () => bsToAd,
+  formatAdDate: () => formatAdDate,
+  formatBsDate: () => formatBsDate,
+  getAllCalendarData: () => getAllCalendarData,
+  getCalendarData: () => getCalendarData,
+  getDataRange: () => getDataRange,
+  getDaysInAdMonth: () => getDaysInAdMonth,
+  getDaysInRange: () => getDaysInRange,
+  getEnglishMonthName: () => getEnglishMonthName,
+  getNepaliMonthName: () => getNepaliMonthName,
+  getNextMonth: () => getNextMonth,
+  getPrevMonth: () => getPrevMonth,
+  getTotalDaysInMonth: () => getTotalDaysInMonth,
+  getTotalDaysInYear: () => getTotalDaysInYear,
+  hasDataForYear: () => hasDataForYear,
+  isLeapYear: () => isLeapYear,
+  isValidAdDate: () => isValidAdDate,
+  isValidBsDate: () => isValidBsDate,
+  parseDate: () => parseDate,
+  toArray: () => toArray,
+  toIsoString: () => toIsoString
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types/index.ts
+var NepaliMonth = /* @__PURE__ */ ((NepaliMonth2) => {
+  NepaliMonth2[NepaliMonth2["Baisakh"] = 1] = "Baisakh";
+  NepaliMonth2[NepaliMonth2["Jestha"] = 2] = "Jestha";
+  NepaliMonth2[NepaliMonth2["Ashar"] = 3] = "Ashar";
+  NepaliMonth2[NepaliMonth2["Shrawan"] = 4] = "Shrawan";
+  NepaliMonth2[NepaliMonth2["Bhadra"] = 5] = "Bhadra";
+  NepaliMonth2[NepaliMonth2["Ashwin"] = 6] = "Ashwin";
+  NepaliMonth2[NepaliMonth2["Kartik"] = 7] = "Kartik";
+  NepaliMonth2[NepaliMonth2["Mangsir"] = 8] = "Mangsir";
+  NepaliMonth2[NepaliMonth2["Poush"] = 9] = "Poush";
+  NepaliMonth2[NepaliMonth2["Magh"] = 10] = "Magh";
+  NepaliMonth2[NepaliMonth2["Falgun"] = 11] = "Falgun";
+  NepaliMonth2[NepaliMonth2["Chaitra"] = 12] = "Chaitra";
+  return NepaliMonth2;
+})(NepaliMonth || {});
+var NEPALI_MONTH_NAMES_EN = {
+  1: "Baisakh",
+  2: "Jestha",
+  3: "Ashar",
+  4: "Shrawan",
+  5: "Bhadra",
+  6: "Ashwin",
+  7: "Kartik",
+  8: "Mangsir",
+  9: "Poush",
+  10: "Magh",
+  11: "Falgun",
+  12: "Chaitra"
+};
+var NEPALI_MONTH_NAMES_NE = {
+  1: "\u092C\u0948\u0936\u093E\u0916",
+  2: "\u091C\u0947\u0920",
+  3: "\u0905\u0938\u093E\u0930",
+  4: "\u0936\u094D\u0930\u093E\u0935\u0923",
+  5: "\u092D\u093E\u0926\u094D\u0930",
+  6: "\u0906\u0936\u094D\u0935\u093F\u0928",
+  7: "\u0915\u093E\u0930\u094D\u0924\u093F\u0915",
+  8: "\u092E\u0902\u0938\u093F\u0930",
+  9: "\u092A\u094C\u0937",
+  10: "\u092E\u093E\u0918",
+  11: "\u092B\u093E\u0932\u094D\u0917\u0941\u0928",
+  12: "\u091A\u0948\u0924\u094D\u0930"
+};
+var ENGLISH_MONTH_NAMES = {
+  1: "January",
+  2: "February",
+  3: "March",
+  4: "April",
+  5: "May",
+  6: "June",
+  7: "July",
+  8: "August",
+  9: "September",
+  10: "October",
+  11: "November",
+  12: "December"
+};
+
+// data/calendar-data.json
+var calendar_data_default = {
+  $schema: "http://json-schema.org/draft-07/schema#",
+  description: "Nepali Calendar Data (Bikram Sambat). Each year maps to an array of 12 numbers representing the days in each month. Months: [Baisakh, Jestha, Ashar, Shrawan, Bhadra, Ashwin, Kartik, Mangsir, Poush, Magh, Falgun, Chaitra]. Data Sources: Nepal Panchanga Nirnayak Samiti, verified against historical records. Data Range: BS 2000 - 2100 (AD 1943 - 2043)",
+  "2000": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2001": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2002": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2003": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2004": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2005": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2006": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2007": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2008": [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 29, 31],
+  "2009": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2010": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2011": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2012": [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+  "2013": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2014": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2015": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2016": [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+  "2017": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2018": [31, 32, 31, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2019": [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2020": [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2021": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2022": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+  "2023": [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2024": [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2025": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2026": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2027": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2028": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2029": [31, 31, 32, 31, 32, 30, 30, 29, 30, 29, 30, 30],
+  "2030": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2031": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2032": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2033": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2034": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2035": [30, 32, 31, 32, 31, 31, 29, 30, 30, 29, 29, 31],
+  "2036": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2037": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2038": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2039": [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+  "2040": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2041": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2042": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2043": [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+  "2044": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2045": [31, 32, 31, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2046": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2047": [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2048": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2049": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+  "2050": [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2051": [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2052": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2053": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+  "2054": [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2055": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2056": [31, 31, 32, 31, 32, 30, 30, 29, 30, 29, 30, 30],
+  "2057": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2058": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2059": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2060": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2061": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2062": [30, 32, 31, 32, 31, 31, 29, 30, 29, 30, 29, 31],
+  "2063": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2064": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2065": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2066": [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 29, 31],
+  "2067": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2068": [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2069": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2070": [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+  "2071": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2072": [31, 32, 31, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2073": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+  "2074": [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2075": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2076": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+  "2077": [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+  "2078": [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2079": [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+  "2080": [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+  "2081": [31, 31, 32, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2082": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2083": [31, 31, 32, 31, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2084": [31, 31, 32, 31, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2085": [31, 32, 31, 32, 30, 31, 30, 30, 29, 30, 30, 30],
+  "2086": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2087": [31, 31, 32, 31, 31, 31, 30, 30, 29, 30, 30, 30],
+  "2088": [30, 31, 32, 32, 30, 31, 30, 30, 29, 30, 30, 30],
+  "2089": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2090": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2091": [31, 31, 32, 31, 31, 31, 30, 30, 29, 30, 30, 30],
+  "2092": [30, 31, 32, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2093": [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2094": [31, 31, 32, 31, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2095": [31, 31, 32, 31, 31, 31, 30, 29, 30, 30, 30, 30],
+  "2096": [30, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+  "2097": [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+  "2098": [31, 31, 32, 31, 31, 31, 29, 30, 29, 30, 30, 31],
+  "2099": [31, 31, 32, 31, 31, 31, 30, 29, 29, 30, 30, 30],
+  "2100": [31, 32, 31, 32, 30, 31, 30, 29, 30, 29, 30, 30]
+};
+
+// src/data/calendar-data.ts
+var NEPALI_CALENDAR_DATA = Object.fromEntries(
+  Object.entries(calendar_data_default).filter(([key]) => !key.startsWith("$") && key !== "description").map(([key, value]) => [Number(key), value])
+);
+var MIN_YEAR = Math.min(...Object.keys(NEPALI_CALENDAR_DATA).map(Number));
+var MAX_YEAR = Math.max(...Object.keys(NEPALI_CALENDAR_DATA).map(Number));
+
+// data/reference-dates.json
+var reference_dates_default = {
+  $schema: "http://json-schema.org/draft-07/schema#",
+  description: "Reference date pairs for validation and testing. These are verified BS-AD date pairs used to validate conversion accuracy. Each pair represents a known accurate conversion point. Sources: Official Nepal government publications, historical records and verified events, cross-referenced with multiple calendar systems.",
+  referenceDates: [
+    {
+      bs: { year: 2001, month: 1, day: 1 },
+      ad: { year: 1944, month: 4, day: 13 }
+    },
+    {
+      bs: { year: 2010, month: 1, day: 1 },
+      ad: { year: 1953, month: 4, day: 13 }
+    },
+    {
+      bs: { year: 2015, month: 1, day: 1 },
+      ad: { year: 1958, month: 4, day: 13 }
+    },
+    {
+      bs: { year: 2025, month: 1, day: 1 },
+      ad: { year: 1968, month: 4, day: 13 }
+    },
+    {
+      bs: { year: 2035, month: 1, day: 1 },
+      ad: { year: 1978, month: 4, day: 14 }
+    },
+    {
+      bs: { year: 2045, month: 1, day: 1 },
+      ad: { year: 1988, month: 4, day: 13 }
+    },
+    {
+      bs: { year: 2055, month: 1, day: 1 },
+      ad: { year: 1998, month: 4, day: 14 }
+    },
+    {
+      bs: { year: 2065, month: 1, day: 1 },
+      ad: { year: 2008, month: 4, day: 13 }
+    },
+    {
+      bs: { year: 2075, month: 1, day: 1 },
+      ad: { year: 2018, month: 4, day: 14 }
+    },
+    {
+      bs: { year: 2082, month: 1, day: 1 },
+      ad: { year: 2025, month: 4, day: 14 }
+    },
+    {
+      bs: { year: 2083, month: 1, day: 1 },
+      ad: { year: 2026, month: 4, day: 14 }
+    }
+  ]
+};
+
+// src/data/reference-dates.ts
+var BASE_BS_DATE = { year: 2e3, month: 1, day: 1 };
+var BASE_AD_DATE = { year: 1943, month: 4, day: 14 };
+var REFERENCE_DATES = reference_dates_default.referenceDates.map(
+  ({ bs, ad }) => ({ bs, ad })
+);
+
+// src/utils/validators.ts
+function hasDataForYear(year) {
+  return year in NEPALI_CALENDAR_DATA;
+}
+function isValidBsDate(year, month, day) {
+  if (year < MIN_YEAR || year > MAX_YEAR) {
+    return false;
+  }
+  if (!hasDataForYear(year)) {
+    return false;
+  }
+  if (month < 1 || month > 12) {
+    return false;
+  }
+  const daysInMonth = NEPALI_CALENDAR_DATA[year][month - 1];
+  if (day < 1 || day > daysInMonth) {
+    return false;
+  }
+  return true;
+}
+function isValidAdDate(year, month, day) {
+  if (year < 1 || year > 9999) {
+    return false;
+  }
+  if (month < 1 || month > 12) {
+    return false;
+  }
+  const daysInMonth = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  if (month === 2 && isLeapYear(year)) {
+    daysInMonth[1] = 29;
+  }
+  if (day < 1 || day > daysInMonth[month - 1]) {
+    return false;
+  }
+  return true;
+}
+function isLeapYear(year) {
+  return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+}
+function getDaysInAdMonth(year, month) {
+  const daysInMonth = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  if (month === 2 && isLeapYear(year)) {
+    return 29;
+  }
+  return daysInMonth[month - 1];
+}
+
+// src/converters/bs-to-ad.ts
+function bsToAd(year, month, day, options) {
+  if (!isValidBsDate(year, month, day)) {
+    throw new Error(`Invalid BS date: ${year}-${month}-${day}`);
+  }
+  let totalDays = 0;
+  for (let y = BASE_BS_DATE.year; y < year; y++) {
+    if (y in NEPALI_CALENDAR_DATA) {
+      totalDays += NEPALI_CALENDAR_DATA[y].reduce((sum, days) => sum + days, 0);
+    }
+  }
+  for (let m = 0; m < month - 1; m++) {
+    totalDays += NEPALI_CALENDAR_DATA[year][m];
+  }
+  totalDays += day - 1;
+  const adDate = addDaysToAdDate(
+    BASE_AD_DATE.year,
+    BASE_AD_DATE.month,
+    BASE_AD_DATE.day,
+    totalDays
+  );
+  return formatDate(adDate, options);
+}
+function addDaysToAdDate(year, month, day, daysToAdd) {
+  let y = year;
+  let m = month;
+  let d = day;
+  for (let i = 0; i < daysToAdd; i++) {
+    d++;
+    const daysInCurrentMonth = getDaysInAdMonth(y, m);
+    if (d > daysInCurrentMonth) {
+      d = 1;
+      m++;
+      if (m > 12) {
+        m = 1;
+        y++;
+      }
+    }
+  }
+  return { year: y, month: m, day: d };
+}
+function formatDate(date, options) {
+  const format = options?.format || "object";
+  switch (format) {
+    case "object":
+      return date;
+    case "iso":
+      return `${date.year}-${String(date.month).padStart(2, "0")}-${String(date.day).padStart(2, "0")}`;
+    case "string": {
+      const pattern = options?.pattern || "YYYY-MM-DD";
+      return pattern.replace("YYYY", String(date.year)).replace("MM", String(date.month).padStart(2, "0")).replace("DD", String(date.day).padStart(2, "0"));
+    }
+    case "array":
+      return [date.year, date.month, date.day];
+    default:
+      return date;
+  }
+}
+
+// src/converters/ad-to-bs.ts
+function adToBs(year, month, day, options) {
+  if (!isValidAdDate(year, month, day)) {
+    throw new Error(`Invalid AD date: ${year}-${month}-${day}`);
+  }
+  const totalDaysFromBase = calculateDaysBetweenAdDates(
+    BASE_AD_DATE.year,
+    BASE_AD_DATE.month,
+    BASE_AD_DATE.day,
+    year,
+    month,
+    day
+  );
+  if (totalDaysFromBase < 0) {
+    throw new Error(`Date is before the minimum supported date (${BASE_AD_DATE.year}-${BASE_AD_DATE.month}-${BASE_AD_DATE.day})`);
+  }
+  const bsDate = addDaysToBsDate(
+    BASE_BS_DATE.year,
+    BASE_BS_DATE.month,
+    BASE_BS_DATE.day,
+    totalDaysFromBase
+  );
+  return formatDate2(bsDate, options);
+}
+function calculateDaysBetweenAdDates(fromYear, fromMonth, fromDay, toYear, toMonth, toDay) {
+  let days = 0;
+  if (toYear < fromYear || toYear === fromYear && toMonth < fromMonth || toYear === fromYear && toMonth === fromMonth && toDay < fromDay) {
+    return -1;
+  }
+  let y = fromYear;
+  let m = fromMonth;
+  let d = fromDay;
+  while (y !== toYear || m !== toMonth || d !== toDay) {
+    d++;
+    const daysInMonth = getDaysInAdMonth(y, m);
+    if (d > daysInMonth) {
+      d = 1;
+      m++;
+      if (m > 12) {
+        m = 1;
+        y++;
+      }
+    }
+    days++;
+  }
+  return days;
+}
+function addDaysToBsDate(year, month, day, daysToAdd) {
+  let y = year;
+  let m = month;
+  let d = day;
+  for (let i = 0; i < daysToAdd; i++) {
+    d++;
+    const daysInCurrentMonth = NEPALI_CALENDAR_DATA[y][m - 1];
+    if (d > daysInCurrentMonth) {
+      d = 1;
+      m++;
+      if (m > 12) {
+        m = 1;
+        y++;
+      }
+      if (y > MAX_YEAR) {
+        throw new Error(`Date exceeds maximum supported year (BS ${MAX_YEAR})`);
+      }
+      if (!(y in NEPALI_CALENDAR_DATA)) {
+        throw new Error(`No calendar data available for BS year ${y}`);
+      }
+    }
+  }
+  return { year: y, month: m, day: d };
+}
+function formatDate2(date, options) {
+  const format = options?.format || "object";
+  switch (format) {
+    case "object":
+      return date;
+    case "iso":
+      return `${date.year}-${String(date.month).padStart(2, "0")}-${String(date.day).padStart(2, "0")}`;
+    case "string": {
+      const pattern = options?.pattern || "YYYY-MM-DD";
+      return pattern.replace("YYYY", String(date.year)).replace("MM", String(date.month).padStart(2, "0")).replace("DD", String(date.day).padStart(2, "0"));
+    }
+    case "array":
+      return [date.year, date.month, date.day];
+    default:
+      return date;
+  }
+}
+
+// src/utils/date-helpers.ts
+function getTotalDaysInMonth(year, month) {
+  if (!hasDataForYear(year)) {
+    throw new Error(`No data available for year ${year}`);
+  }
+  if (month < 1 || month > 12) {
+    throw new Error(`Invalid month: ${month}. Month must be between 1 and 12.`);
+  }
+  return NEPALI_CALENDAR_DATA[year][month - 1];
+}
+function getTotalDaysInYear(year) {
+  if (!hasDataForYear(year)) {
+    throw new Error(`No data available for year ${year}`);
+  }
+  return NEPALI_CALENDAR_DATA[year].reduce((sum, days) => sum + days, 0);
+}
+function getNextMonth(year, month) {
+  if (month < 1 || month > 12) {
+    throw new Error(`Invalid month: ${month}. Month must be between 1 and 12.`);
+  }
+  if (month === 12) {
+    const nextYear = year + 1;
+    if (!hasDataForYear(nextYear)) {
+      throw new Error(`No data available for year ${nextYear}`);
+    }
+    return { year: nextYear, month: 1 };
+  }
+  return { year, month: month + 1 };
+}
+function getPrevMonth(year, month) {
+  if (month < 1 || month > 12) {
+    throw new Error(`Invalid month: ${month}. Month must be between 1 and 12.`);
+  }
+  if (month === 1) {
+    const prevYear = year - 1;
+    if (!hasDataForYear(prevYear)) {
+      throw new Error(`No data available for year ${prevYear}`);
+    }
+    return { year: prevYear, month: 12 };
+  }
+  return { year, month: month - 1 };
+}
+function getCalendarData(year) {
+  if (!hasDataForYear(year)) {
+    throw new Error(`No data available for year ${year}`);
+  }
+  return [...NEPALI_CALENDAR_DATA[year]];
+}
+function getDataRange() {
+  return {
+    minYear: MIN_YEAR,
+    maxYear: MAX_YEAR,
+    totalYears: MAX_YEAR - MIN_YEAR + 1
+  };
+}
+function getDaysInRange(fromYear, fromMonth, fromDay, toYear, toMonth, toDay) {
+  if (!hasDataForYear(fromYear) || !hasDataForYear(toYear)) {
+    throw new Error("One or more years are outside the available data range");
+  }
+  let days = 0;
+  let currentYear = fromYear;
+  let currentMonth = fromMonth;
+  let currentDay = fromDay;
+  const isForward = toYear > fromYear || toYear === fromYear && toMonth > fromMonth || toYear === fromYear && toMonth === fromMonth && toDay >= fromDay;
+  if (!isForward) {
+    while (currentYear > toYear || currentMonth > toMonth || currentDay > toDay) {
+      currentDay--;
+      days--;
+      if (currentDay < 1) {
+        const prevMonth = getPrevMonth(currentYear, currentMonth);
+        currentYear = prevMonth.year;
+        currentMonth = prevMonth.month;
+        currentDay = getTotalDaysInMonth(currentYear, currentMonth);
+      }
+      if (currentYear === toYear && currentMonth === toMonth && currentDay === toDay) {
+        break;
+      }
+    }
+  } else {
+    while (currentYear < toYear || currentMonth < toMonth || currentDay < toDay) {
+      currentDay++;
+      days++;
+      const daysInMonth = getTotalDaysInMonth(currentYear, currentMonth);
+      if (currentDay > daysInMonth) {
+        const nextMonth = getNextMonth(currentYear, currentMonth);
+        currentYear = nextMonth.year;
+        currentMonth = nextMonth.month;
+        currentDay = 1;
+      }
+      if (currentYear === toYear && currentMonth === toMonth && currentDay === toDay) {
+        break;
+      }
+    }
+  }
+  return days;
+}
+function getAllCalendarData() {
+  return { ...NEPALI_CALENDAR_DATA };
+}
+
+// src/utils/formatters.ts
+function formatBsDate(year, month, day, options) {
+  const pattern = options?.pattern || "YYYY-MM-DD";
+  return formatWithPattern(year, month, day, pattern);
+}
+function formatAdDate(year, month, day, options) {
+  const pattern = options?.pattern || "YYYY-MM-DD";
+  return formatWithPattern(year, month, day, pattern);
+}
+function formatWithPattern(year, month, day, pattern) {
+  return pattern.replace("YYYY", String(year)).replace("MM", String(month).padStart(2, "0")).replace("DD", String(day).padStart(2, "0"));
+}
+function getNepaliMonthName(month, locale = "en") {
+  if (month < 1 || month > 12) {
+    throw new Error(`Invalid month: ${month}. Month must be between 1 and 12.`);
+  }
+  if (locale === "ne") {
+    return NEPALI_MONTH_NAMES_NE[month];
+  }
+  return NEPALI_MONTH_NAMES_EN[month];
+}
+function getEnglishMonthName(month) {
+  if (month < 1 || month > 12) {
+    throw new Error(`Invalid month: ${month}. Month must be between 1 and 12.`);
+  }
+  return ENGLISH_MONTH_NAMES[month];
+}
+function parseDate(dateString, pattern = "YYYY-MM-DD") {
+  const separator = pattern.includes("-") ? "-" : "/";
+  const parts = dateString.split(separator);
+  if (parts.length !== 3) {
+    throw new Error(`Invalid date string: ${dateString}`);
+  }
+  const patternParts = pattern.split(separator);
+  const dateObj = { year: 0, month: 0, day: 0 };
+  for (let i = 0; i < patternParts.length; i++) {
+    const value = parseInt(parts[i], 10);
+    if (isNaN(value)) {
+      throw new Error(`Invalid date value in: ${dateString}`);
+    }
+    switch (patternParts[i]) {
+      case "YYYY":
+        dateObj.year = value;
+        break;
+      case "MM":
+        dateObj.month = value;
+        break;
+      case "DD":
+        dateObj.day = value;
+        break;
+    }
+  }
+  if (dateObj.year === 0 || dateObj.month === 0 || dateObj.day === 0) {
+    throw new Error(`Failed to parse date: ${dateString}`);
+  }
+  return dateObj;
+}
+function toIsoString(date) {
+  return `${date.year}-${String(date.month).padStart(2, "0")}-${String(date.day).padStart(2, "0")}`;
+}
+function toArray(date) {
+  return [date.year, date.month, date.day];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BASE_AD_DATE,
+  BASE_BS_DATE,
+  ENGLISH_MONTH_NAMES,
+  MAX_YEAR,
+  MIN_YEAR,
+  NEPALI_CALENDAR_DATA,
+  NEPALI_MONTH_NAMES_EN,
+  NEPALI_MONTH_NAMES_NE,
+  NepaliMonth,
+  REFERENCE_DATES,
+  adToBs,
+  bsToAd,
+  formatAdDate,
+  formatBsDate,
+  getAllCalendarData,
+  getCalendarData,
+  getDataRange,
+  getDaysInAdMonth,
+  getDaysInRange,
+  getEnglishMonthName,
+  getNepaliMonthName,
+  getNextMonth,
+  getPrevMonth,
+  getTotalDaysInMonth,
+  getTotalDaysInYear,
+  hasDataForYear,
+  isLeapYear,
+  isValidAdDate,
+  isValidBsDate,
+  parseDate,
+  toArray,
+  toIsoString
+});