@wesantal/santali-calendar 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WeSantal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,191 @@
+# @wesantal/santali-calendar
+
+A framework-independent Santali Calendar data and utility package for JavaScript and TypeScript applications.
+
+Maps the traditional Santali lunisolar calendar onto the Gregorian calendar using the 19-year Metonic cycle for leap year calculation.
+
+## Installation
+
+```bash
+npm install @wesantal/santali-calendar
+# or
+bun add @wesantal/santali-calendar
+```
+
+## Usage
+
+```typescript
+import {
+  getCalendar,
+  getToday,
+  getDate,
+  getMonth,
+  isLeapYear,
+  weekDays,
+  festivals,
+  months,
+  formatDate,
+  formatDateShort,
+  toOlChikiNumeral,
+} from "@wesantal/santali-calendar";
+
+// Get today's Santali date
+const today = getToday();
+// { day: 15, year: 2026, month: "ᱢᱟᱜᱽ", monthIndex: 0, startDate: "...", endDate: "..." }
+
+// Convert any Gregorian date
+const date = getDate(new Date("2026-06-15"));
+
+// Get full calendar grid for a year
+const calendar = getCalendar(2026);
+
+// Check leap year
+isLeapYear(2026);  // true (Metonic position 1)
+isLeapYear(2027);  // false
+
+// Get a single month
+const magh = getMonth(2026, 0);
+
+// Convert numbers to Ol Chiki script
+toOlChikiNumeral(2026); // "᱒᱐᱒᱖"
+
+// Format dates
+formatDate("2026-01-19T00:00:00.000Z");      // "19 January 2026"
+formatDateShort("2026-01-19T00:00:00.000Z"); // "19 Jan 2026"
+```
+
+## Calendar Structure
+
+`getCalendar(year)` returns a `BuiltSantaliCalendarYear`:
+
+```typescript
+{
+  year: 2026,
+  startDate: "2026-01-19T00:00:00.000Z",
+  endDate: "2027-01-07T00:00:00.000Z",
+  months: [
+    {
+      name: "ᱢᱟᱜᱽ",
+      days: 30,
+      startDate: "2026-01-19T00:00:00.000Z",
+      endDate: "2026-02-17T00:00:00.000Z",
+      calendar: {
+        sun: [null, { day: 7, date: "...", isCurrentMonth: true }, ...],
+        mon: [{ day: 1, date: "...", isCurrentMonth: true }, ...],
+        // ... all 7 weekdays
+      }
+    },
+    // ... 12 or 13 months
+  ]
+}
+```
+
+### Calendar Grid
+
+Each weekday column (`sun`, `mon`, `tue`, `wed`, `thu`, `fri`, `sat`) contains cells that are either:
+
+- A `SantaliCalendarDay` object:
+  ```typescript
+  { day: 1, date: "2026-01-19T00:00:00.000Z", isCurrentMonth: true }
+  ```
+- `null` for empty padding cells
+
+## Santali Months
+
+| # | Name | Ol Chiki | Days |
+|---|------|----------|------|
+| 0 | Mag | ᱢᱟᱜᱽ | 30 |
+| 1 | Phagun | ᱯᱷᱟ.ᱜᱩᱱ | 29 |
+| 2 | Chaat | ᱪᱟ.ᱛ | 30 |
+| 3 | Baisak | ᱵᱟ.ᱭᱥᱟ.ᱠ | 29 |
+| 4 | Jhent | ᱡᱷᱮᱸᱴ | 30 |
+| 5 | Asal | ᱟᱥᱟᱲ | 29 |
+| 6 | Saan | ᱥᱟᱱ | 30 |
+| 7 | Bhador | ᱵᱷᱟᱫᱚᱨ | 29 |
+| 8 | Dasain | ᱫᱟᱥᱟᱸᱭ | 30 |
+| 9 | Saharay | ᱥᱚᱦᱨᱟᱭ | 29 |
+| 10 | Aghan | ᱟᱜᱷᱟᱬ | 30 |
+| 11 | Pus | ᱯᱩᱥ | 29 |
+
+**Normal year:** 354 days (12 months). **Leap year:** 384 days (adds Sarcha, a 30-day intercalary month).
+
+## Gregorian Date Mapping
+
+A Santali month spans parts of two Gregorian months. Example:
+
+- **ᱢᱟᱜᱽ (Mag) 2026:** January 19 – February 17
+
+```
+ᱢᱟᱜᱽ (Mag)
+sun  null  7* 14* 21* 28*
+mon   1*  8* 15* 22* 29*
+tue   2*  9* 16* 23* 30*
+wed   3* 10* 17* 24*  1
+thu   4* 11* 18* 25*  2
+fri   5* 12* 19* 26*  3
+sat   6* 13* 20* 27*  4
+
+* = current month day
+numbers without * = next month overflow
+null = empty cell
+```
+
+## API Reference
+
+| Function | Description |
+|----------|-------------|
+| `getCalendar(year)` | Full calendar grid for a Santali year |
+| `getMonth(year, monthIndex)` | Single month with calendar grid |
+| `getToday()` | Today's Santali date |
+| `getDate(date)` | Convert a Gregorian date to Santali |
+| `isLeapYear(year)` | Check if year has 13 months |
+| `buildYearStart(year)` | Gregorian start date for a Santali year |
+| `formatDate(iso)` | Long format date (e.g. "19 January 2026") |
+| `formatDateShort(iso)` | Short format date (e.g. "19 Jan 2026") |
+| `toOlChikiNumeral(n)` | Convert number to Ol Chiki script |
+
+### Constants
+
+| Export | Description |
+|--------|-------------|
+| `months` | Array of 12 base month definitions |
+| `festivals` | Array of 11 festivals with metadata |
+| `weekDays` | Weekday names in Ol Chiki script |
+| `METONIC_CYCLE_START` | Metonic cycle anchor year (2026) |
+| `METONIC_LEAP_POS` | Set of leap positions within the cycle |
+
+## Festivals
+
+```typescript
+import { festivals } from "@wesantal/santali-calendar";
+
+festivals.forEach((f) => {
+  console.log(`${f.name}: ${f.date ?? "Date varies"}`);
+});
+```
+
+Each festival includes `id`, `name`, `date`, `santaliMonth`, `description`, and `type` (`"festival"`, `"cultural"`, or `"community"`).
+
+## TypeScript
+
+Full type support:
+
+```typescript
+import type {
+  WeekDay,
+  SantaliMonth,
+  SantaliCalendarYear,
+  SantaliCalendar,
+  SantaliCalendarDay,
+  SantaliCalendarDayCell,
+  SantaliCalendarMonth,
+  BuiltSantaliCalendarYear,
+  SantaliMonthInfo,
+  SantaliFestival,
+  TodaySantaliDate,
+} from "@wesantal/santali-calendar";
+```
+
+## License
+
+MIT

package/dist/calendar.utils.d.ts

@@ -0,0 +1,3 @@
+import { SantaliCalendarMonth, SantaliMonth } from "./types.js";
+export declare function buildNormalMonth(month: SantaliMonth, previousMonth?: SantaliMonth, nextMonth?: SantaliMonth): SantaliCalendarMonth;
+//# sourceMappingURL=calendar.utils.d.ts.map

package/dist/calendar.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.utils.d.ts","sourceRoot":"","sources":["../src/calendar.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,oBAAoB,EACpB,YAAY,EAEb,MAAM,YAAY,CAAC;AAiDpB,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,aAAa,CAAC,EAAE,YAAY,EAC5B,SAAS,CAAC,EAAE,YAAY,GACvB,oBAAoB,CAyDtB"}

package/dist/calendar.utils.js

@@ -0,0 +1,90 @@
+import { addDays, formatDate, getDay, isToday, toDate } from "date-fns";
+import { toOlChikiNumeral } from "./number.utils.js";
+const WEEKDAY_INDEX = [
+    "sun",
+    "mon",
+    "tue",
+    "wed",
+    "thu",
+    "fri",
+    "sat",
+];
+function createCalendarDay(day, date, isCurrentMonth) {
+    return {
+        day: toOlChikiNumeral(day),
+        date: formatDate(date, "yyyy-MM-dd"),
+        isCurrentMonth,
+        isToday: isToday(date),
+    };
+}
+const EMPTY_CALENDAR = () => ({
+    sun: [],
+    mon: [],
+    tue: [],
+    wed: [],
+    thu: [],
+    fri: [],
+    sat: [],
+});
+function cellsToCalendar(cells) {
+    const calendar = EMPTY_CALENDAR();
+    const rows = Math.ceil(cells.length / 7);
+    for (let row = 0; row < rows; row++) {
+        for (let col = 0; col < 7; col++) {
+            const index = row * 7 + col;
+            calendar[WEEKDAY_INDEX[col]][row] = cells[index] ?? null;
+        }
+    }
+    return calendar;
+}
+export function buildNormalMonth(month, previousMonth, nextMonth) {
+    const cells = [];
+    const startDow = getDay(toDate(month.startDate));
+    /*
+     * Previous month days.
+     * Gregorian calendar jaisa leading dates.
+     */
+    if (previousMonth) {
+        const previousStart = toDate(previousMonth.startDate);
+        const firstPreviousDay = previousMonth.days - startDow + 1;
+        for (let day = firstPreviousDay; day <= previousMonth.days; day++) {
+            cells.push({
+                isToday: false,
+                isCurrentMonth: false,
+                day: toOlChikiNumeral(day),
+                date: formatDate(addDays(previousStart, day - 1), "yyyy-MM-dd"),
+            });
+        }
+    }
+    else {
+        for (let i = 0; i < startDow; i++) {
+            cells.push(null);
+        }
+    }
+    /*
+     * Current month.
+     */
+    for (let day = 1; day <= month.days; day++) {
+        cells.push(createCalendarDay(day, addDays(toDate(month.startDate), day - 1), true));
+    }
+    /*
+     * Gregorian calendars normally complete
+     * the final week with next-month dates.
+     */
+    const remainder = cells.length % 7;
+    if (remainder !== 0 && nextMonth) {
+        const required = 7 - remainder;
+        const nextStart = toDate(nextMonth.startDate);
+        for (let day = 1; day <= required && day <= nextMonth.days; day++) {
+            cells.push(createCalendarDay(day, addDays(nextStart, day - 1), false));
+        }
+    }
+    while (cells.length % 7 !== 0) {
+        cells.push(null);
+    }
+    return {
+        ...month,
+        weeks: cellsToCalendar(cells),
+    };
+}
+//# sourceMappingURL=calendar.utils.js.map

package/dist/calendar.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.utils.js","sourceRoot":"","sources":["../src/calendar.utils.ts"],"names":[],"mappings":"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"}

package/dist/festivals.d.ts

@@ -0,0 +1,3 @@
+import type { SantaliFestival } from "./types.js";
+export declare const festivals: SantaliFestival[];
+//# sourceMappingURL=festivals.d.ts.map

package/dist/festivals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"festivals.d.ts","sourceRoot":"","sources":["../src/festivals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,SAAS,EAAE,eAAe,EA2FtC,CAAC"}

package/dist/festivals.js

@@ -0,0 +1,86 @@
+export const festivals = [
+    {
+        id: "baha-2026",
+        name: "Baha Puja (Flower Festival)",
+        date: "2026-03-05",
+        santaliMonth: "Phagun",
+        description: "Santali flower festival welcoming spring, one of the most beloved celebrations of the Santali people.",
+        type: "cultural",
+    },
+    {
+        id: "karma-puja-2026",
+        name: "Karma Puja",
+        date: "2026-08-28",
+        santaliMonth: "Bhadon",
+        description: "Santali festival worshipping the Karma tree, celebrated by youth for prosperity and good fortune.",
+        type: "cultural",
+    },
+    {
+        id: "sohrae-2026",
+        name: "Sohrae",
+        date: "2026-10-25",
+        santaliMonth: "Kunwar",
+        description: "Santali harvest festival — the most important festival of the Santali people, celebrating the new harvest.",
+        type: "festival",
+    },
+    {
+        id: "mage-parab-2026",
+        name: "Mage Parab",
+        date: "2026-01-25",
+        santaliMonth: "Mag",
+        description: "An important Santali festival celebrated in the month of Mag with community prayers and feasting.",
+        type: "cultural",
+    },
+    {
+        id: "ero-2026",
+        name: "Ero",
+        date: "2026-04-15",
+        santaliMonth: "Jeth",
+        description: "A Santali sowing festival marking the beginning of the agricultural season.",
+        type: "community",
+    },
+    {
+        id: "bandna-2026",
+        name: "Bandna",
+        date: "2026-09-15",
+        santaliMonth: "Kati",
+        description: "A cattle-worshipping festival celebrated by Adivasi communities including the Santali.",
+        type: "community",
+    },
+    {
+        id: "republic-day-2026",
+        name: "Republic Day (India)",
+        date: "2026-01-26",
+        description: "India adopted its constitution on this day in 1950.",
+        type: "festival",
+    },
+    {
+        id: "holi-2026",
+        name: "Holi",
+        date: "2026-03-04",
+        description: "Festival of colours celebrated across India.",
+        type: "festival",
+    },
+    {
+        id: "independence-day-2026",
+        name: "Independence Day (India)",
+        date: "2026-08-15",
+        description: "India gained independence from British rule on 15 August 1947.",
+        type: "festival",
+    },
+    {
+        id: "gandhi-jayanti-2026",
+        name: "Gandhi Jayanti",
+        date: "2026-10-02",
+        description: "Birth anniversary of Mahatma Gandhi, Father of the Nation.",
+        type: "festival",
+    },
+    {
+        id: "christmas-2026",
+        name: "Christmas Day",
+        date: "2026-12-25",
+        description: "Christian festival celebrating the birth of Jesus Christ.",
+        type: "festival",
+    },
+];
+//# sourceMappingURL=festivals.js.map

package/dist/festivals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"festivals.js","sourceRoot":"","sources":["../src/festivals.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAsB;IAC1C;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,6BAA6B;QACnC,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,QAAQ;QACtB,WAAW,EACT,uGAAuG;QACzG,IAAI,EAAE,UAAU;KACjB;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,QAAQ;QACtB,WAAW,EACT,mGAAmG;QACrG,IAAI,EAAE,UAAU;KACjB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,QAAQ;QACtB,WAAW,EACT,4GAA4G;QAC9G,IAAI,EAAE,UAAU;KACjB;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,KAAK;QACnB,WAAW,EACT,mGAAmG;QACrG,IAAI,EAAE,UAAU;KACjB;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,MAAM;QACpB,WAAW,EACT,6EAA6E;QAC/E,IAAI,EAAE,WAAW;KAClB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,MAAM;QACpB,WAAW,EACT,wFAAwF;QAC1F,IAAI,EAAE,WAAW;KAClB;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,qDAAqD;QAClE,IAAI,EAAE,UAAU;KACjB;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,8CAA8C;QAC3D,IAAI,EAAE,UAAU;KACjB;IACD;QACE,EAAE,EAAE,uBAAuB;QAC3B,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,gEAAgE;QAClE,IAAI,EAAE,UAAU;KACjB;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,4DAA4D;QACzE,IAAI,EAAE,UAAU;KACjB;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,2DAA2D;QACxE,IAAI,EAAE,UAAU;KACjB;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./festivals.js";
+export * from "./months.js";
+export * from "./number.utils.js";
+export * from "./types.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./festivals.js";
+export * from "./months.js";
+export * from "./number.utils.js";
+export * from "./types.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/leap-year.utils.d.ts

@@ -0,0 +1,5 @@
+export declare const METONIC_CYCLE_START = 2026;
+export declare const METONIC_LEAP_POS: Set<number>;
+export declare const YEAR_ANCHOR_DATE = "2026-01-19T00:00:00.000Z";
+export declare function isLeapYear(y: number): boolean;
+//# sourceMappingURL=leap-year.utils.d.ts.map

package/dist/leap-year.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leap-year.utils.d.ts","sourceRoot":"","sources":["../src/leap-year.utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,gBAAgB,aAAoC,CAAC;AAClE,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAI7C"}

package/dist/leap-year.utils.js

@@ -0,0 +1,9 @@
+export const METONIC_CYCLE_START = 2026;
+export const METONIC_LEAP_POS = new Set([1, 4, 7, 9, 12, 15, 18]);
+export const YEAR_ANCHOR_DATE = "2026-01-19T00:00:00.000Z";
+export function isLeapYear(y) {
+    // Normalize year to a 1-19 position
+    const pos = ((((y - METONIC_CYCLE_START) % 19) + 19) % 19) + 1;
+    return METONIC_LEAP_POS.has(pos);
+}
+//# sourceMappingURL=leap-year.utils.js.map

package/dist/leap-year.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leap-year.utils.js","sourceRoot":"","sources":["../src/leap-year.utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE3D,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,oCAAoC;IACpC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/D,OAAO,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/months.d.ts

@@ -0,0 +1,3 @@
+import { SantaliMonthInfo } from "./types.js";
+export declare const months: SantaliMonthInfo[];
+//# sourceMappingURL=months.d.ts.map

package/dist/months.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"months.d.ts","sourceRoot":"","sources":["../src/months.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAE,gBAAgB,EA6DpC,CAAC"}

package/dist/months.js

@@ -0,0 +1,63 @@
+export const months = [
+    {
+        days: 30,
+        name: "ᱢᱟᱜᱽ",
+        english: "Mag",
+    },
+    {
+        days: 29,
+        name: "ᱯᱷᱟ.ᱜᱩᱱ",
+        english: "Phagun",
+    },
+    {
+        days: 30,
+        name: "ᱪᱟ.ᱛ",
+        english: "Chaat",
+    },
+    {
+        days: 29,
+        name: "ᱵᱟ.ᱭᱥᱟ.ᱠ",
+        english: "Baisak",
+    },
+    {
+        days: 30,
+        name: "ᱡᱷᱮᱸᱴ",
+        english: "Jhent",
+    },
+    {
+        days: 29,
+        name: "ᱟᱥᱟᱲ",
+        english: "Asal",
+    },
+    {
+        days: 30,
+        name: "ᱥᱟᱱ",
+        english: "Saan",
+    },
+    {
+        days: 29,
+        name: "ᱵᱷᱟᱫᱚᱨ",
+        english: "Bhador",
+    },
+    {
+        days: 30,
+        name: "ᱫᱟᱥᱟᱸᱭ",
+        english: "Dasain",
+    },
+    {
+        days: 29,
+        name: "ᱥᱚᱦᱨᱟᱭ",
+        english: "Saharay",
+    },
+    {
+        days: 30,
+        name: "ᱟᱜᱷᱟᱬ",
+        english: "Aghan",
+    },
+    {
+        days: 29,
+        name: "ᱯᱩᱥ",
+        english: "Pus",
+    },
+];
+//# sourceMappingURL=months.js.map

package/dist/months.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"months.js","sourceRoot":"","sources":["../src/months.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAuB;IACxC;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,KAAK;KACf;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,QAAQ;KAClB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,QAAQ;KAClB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,MAAM;KAChB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,MAAM;KAChB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ;KAClB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ;KAClB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;KACnB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;KACf;CACF,CAAC"}

package/dist/number.utils.d.ts

@@ -0,0 +1,3 @@
+/** Convert an Arabic numeral (e.g. 19) to Ol Chiki numeral string (e.g. ᱑᱙). */
+export declare function toOlChikiNumeral(n: number): string;
+//# sourceMappingURL=number.utils.d.ts.map

package/dist/number.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.utils.d.ts","sourceRoot":"","sources":["../src/number.utils.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKlD"}

package/dist/number.utils.js

@@ -0,0 +1,9 @@
+const OL_CHIKI_DIGITS = ["᱐", "᱑", "᱒", "᱓", "᱔", "᱕", "᱖", "᱗", "᱘", "᱙"];
+/** Convert an Arabic numeral (e.g. 19) to Ol Chiki numeral string (e.g. ᱑᱙). */
+export function toOlChikiNumeral(n) {
+    return String(n)
+        .split("")
+        .map((d) => OL_CHIKI_DIGITS[parseInt(d, 10)])
+        .join("");
+}
+//# sourceMappingURL=number.utils.js.map

package/dist/number.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.utils.js","sourceRoot":"","sources":["../src/number.utils.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE3E,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,MAAM,CAAC,CAAC,CAAC;SACb,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;SAC5C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export type WeekDay = "sun" | "mon" | "tue" | "wed" | "thu" | "fri" | "sat";
+export interface SantaliFestival {
+    id: string;
+    name: string;
+    date: string;
+    santaliMonth?: string;
+    description?: string;
+    type?: "festival" | "cultural" | "community";
+}
+export interface SantaliMonthInfo {
+    days: number;
+    name: string;
+    english: string;
+    description?: string;
+}
+export interface SantaliMonth {
+    days: number;
+    name: string;
+    endDate: string;
+    english: string;
+    startDate: string;
+    description?: string;
+}
+export interface SantaliCalendarYear {
+    endDate: string;
+    startDate: string;
+    months: SantaliMonth[];
+}
+export interface TodaySantaliDate {
+    day: number;
+    year: number;
+    month: SantaliMonth;
+    monthIndex: number;
+    monthEndDate: string;
+    gregorianDate: string;
+    monthStartDate: string;
+}
+export type SantaliCalendar = Record<number, SantaliCalendarYear>;
+export interface SantaliCalendarDay {
+    day: string;
+    date: string;
+    isToday: boolean;
+    isCurrentMonth: boolean;
+}
+export type SantaliCalendarDayCell = SantaliCalendarDay | null;
+export interface SantaliCalendarMonth extends SantaliMonth {
+    weeks: Record<WeekDay, SantaliCalendarDayCell[]>;
+}
+export interface BuiltSantaliCalendarYear {
+    year: number;
+    endDate: string;
+    startDate: string;
+    months: SantaliCalendarMonth[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG,IAAI,CAAC;AAE/D,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,89 @@
+import type { BuiltSantaliCalendarYear, SantaliCalendarMonth, SantaliMonth, TodaySantaliDate, WeekDay } from "./types.js";
+export declare const weekDays: Record<WeekDay, string>;
+export declare const santaliWeeks: string[];
+export declare function formatDateShort(iso: string): string;
+/**
+ * Normal Santali year:
+ *
+ * 12 months
+ * 6 × 30 days
+ * 6 × 29 days
+ *
+ * = 354 days
+ *
+ * Santali leap year:
+ *
+ * 354 + 30 Sarcha
+ * = 384 days
+ */
+export declare function getYearDays(year: number): number;
+/**
+ * Returns the number of base-month days.
+ *
+ * This should always be 354.
+ */
+export declare function getBaseMonthDays(): number;
+/**
+ * Validate the month configuration.
+ *
+ * Throws if the base months don't contain exactly 354 days.
+ */
+export declare function validateMonths(): void;
+/**
+ * Calculate the beginning of any Santali year from the known anchor.
+ *
+ * 2026 = YEAR_ANCHOR_DATE
+ *
+ * For future years:
+ *   add each previous year's actual length.
+ *
+ * For previous years:
+ *   subtract each previous year's actual length.
+ *
+ * This is important because a leap year is not necessarily 365/366 days.
+ */
+export declare function buildYearStart(year: number, anchorYear?: number, anchorDate?: string): string;
+/**
+ * Build all months for a particular Santali year.
+ *
+ * The month start dates are calculated automatically.
+ *
+ * Normal year:
+ *   12 months
+ *
+ * Leap year:
+ *   12 months + Sarcha
+ */
+export declare function buildMonths(year: number, yearStartDate: string): SantaliMonth[];
+/**
+ * Get any Santali calendar year.
+ *
+ * Works both for years before and after 2026.
+ */
+export declare function getCalendar(year: number): BuiltSantaliCalendarYear;
+/**
+ * Get one Santali month.
+ *
+ * 0  = Magh
+ * 1  = Phagun
+ * 2  = Chaat
+ * ...
+ * 11 = Pus
+ * 12 = Sarcha (leap year only)
+ */
+export declare function getMonth(year: number, monthIndex: number): SantaliCalendarMonth;
+/**
+ * Convert a Gregorian date into a Santali date.
+ *
+ * The year is first estimated and then corrected against
+ * the actual generated Santali year boundaries.
+ *
+ * This avoids assuming that every Santali year has the
+ * same number of days.
+ */
+export declare function getDate(date: Date | string): TodaySantaliDate;
+/**
+ * Get today's Santali date.
+ */
+export declare function getToday(): TodaySantaliDate;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACR,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAQnC,CAAC;AAEX,eAAO,MAAM,YAAY,UAA0B,CAAC;AAEpD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAQrC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,SAAO,EACjB,UAAU,GAAE,MAAyB,GACpC,MAAM,CAkBR;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GACpB,YAAY,EAAE,CAuChB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAkClE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,oBAAoB,CAetB;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,gBAAgB,CAkE7D;AAMD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,gBAAgB,CAE3C"}

package/dist/utils.js

@@ -0,0 +1,265 @@
+import { addDays, differenceInDays, formatDate, toDate } from "date-fns";
+import { isLeapYear, METONIC_CYCLE_START, YEAR_ANCHOR_DATE, } from "./leap-year.utils.js";
+import { months } from "./months.js";
+import { buildNormalMonth } from "./calendar.utils.js";
+/* -------------------------------------------------------------------------- */
+/* Weekdays                                                                   */
+/* -------------------------------------------------------------------------- */
+export const weekDays = {
+    sun: "ᱥᱤᱸᱜᱤ",
+    mon: "ᱚᱛᱮ",
+    tue: "ᱵᱟᱞᱮ",
+    wed: "ᱥᱟᱹᱜᱩᱱ",
+    thu: "ᱥᱟᱹᱨᱫᱤ",
+    fri: "ᱡᱟᱹᱨᱩᱢ",
+    sat: "ᱧᱩᱦᱩᱢ",
+};
+export const santaliWeeks = Object.values(weekDays);
+export function formatDateShort(iso) {
+    return new Date(iso).toLocaleDateString("en-IN", {
+        day: "numeric",
+        month: "short",
+        year: "numeric",
+    });
+}
+/* -------------------------------------------------------------------------- */
+/* Year rules                                                                 */
+/* -------------------------------------------------------------------------- */
+/**
+ * Normal Santali year:
+ *
+ * 12 months
+ * 6 × 30 days
+ * 6 × 29 days
+ *
+ * = 354 days
+ *
+ * Santali leap year:
+ *
+ * 354 + 30 Sarcha
+ * = 384 days
+ */
+export function getYearDays(year) {
+    return isLeapYear(year) ? 384 : 354;
+}
+/**
+ * Returns the number of base-month days.
+ *
+ * This should always be 354.
+ */
+export function getBaseMonthDays() {
+    return months.reduce((total, month) => total + month.days, 0);
+}
+/**
+ * Validate the month configuration.
+ *
+ * Throws if the base months don't contain exactly 354 days.
+ */
+export function validateMonths() {
+    const total = getBaseMonthDays();
+    if (total !== 354) {
+        throw new Error(`Invalid Santali month configuration: expected 354 days, got ${total}`);
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Year start                                                                  */
+/* -------------------------------------------------------------------------- */
+/**
+ * Calculate the beginning of any Santali year from the known anchor.
+ *
+ * 2026 = YEAR_ANCHOR_DATE
+ *
+ * For future years:
+ *   add each previous year's actual length.
+ *
+ * For previous years:
+ *   subtract each previous year's actual length.
+ *
+ * This is important because a leap year is not necessarily 365/366 days.
+ */
+export function buildYearStart(year, anchorYear = 2026, anchorDate = YEAR_ANCHOR_DATE) {
+    let startDate = toDate(anchorDate);
+    if (year === anchorYear) {
+        return startDate.toISOString();
+    }
+    if (year > anchorYear) {
+        for (let currentYear = anchorYear; currentYear < year; currentYear++) {
+            startDate = addDays(startDate, getYearDays(currentYear));
+        }
+    }
+    else {
+        for (let currentYear = anchorYear - 1; currentYear >= year; currentYear--) {
+            startDate = addDays(startDate, -getYearDays(currentYear));
+        }
+    }
+    return startDate.toISOString();
+}
+/* -------------------------------------------------------------------------- */
+/* Build months                                                               */
+/* -------------------------------------------------------------------------- */
+/**
+ * Build all months for a particular Santali year.
+ *
+ * The month start dates are calculated automatically.
+ *
+ * Normal year:
+ *   12 months
+ *
+ * Leap year:
+ *   12 months + Sarcha
+ */
+export function buildMonths(year, yearStartDate) {
+    validateMonths();
+    let startDate = toDate(yearStartDate);
+    const yearMonths = months.map((month) => {
+        const endDate = addDays(startDate, month.days - 1);
+        const result = {
+            ...month,
+            startDate: startDate.toISOString(),
+            endDate: endDate.toISOString(),
+        };
+        startDate = addDays(startDate, month.days);
+        return result;
+    });
+    /*
+     * Leap year:
+     *
+     * Add the additional Sarcha month.
+     */
+    if (isLeapYear(year)) {
+        const sarchaDays = 30;
+        const endDate = addDays(startDate, sarchaDays - 1);
+        yearMonths.push({
+            days: sarchaDays,
+            name: "ᱥᱚᱨᱪᱟ",
+            english: "Sarcha",
+            startDate: startDate.toISOString(),
+            endDate: endDate.toISOString(),
+        });
+    }
+    return yearMonths;
+}
+/**
+ * Get any Santali calendar year.
+ *
+ * Works both for years before and after 2026.
+ */
+export function getCalendar(year) {
+    if (!Number.isInteger(year)) {
+        throw new TypeError(`Santali year must be an integer: ${year}`);
+    }
+    const startDate = buildYearStart(year);
+    const yearMonths = buildMonths(year, startDate);
+    const totalDays = yearMonths.reduce((total, month) => total + month.days, 0);
+    const expectedDays = getYearDays(year);
+    if (totalDays !== expectedDays) {
+        throw new Error(`Invalid ${year} Santali calendar: ` +
+            `expected ${expectedDays} days, ` +
+            `got ${totalDays} days`);
+    }
+    const endDate = addDays(toDate(startDate), totalDays - 1);
+    return {
+        year,
+        endDate: formatDate(endDate, "yyyy-MM-dd"),
+        startDate: formatDate(startDate, "yyyy-MM-dd"),
+        months: yearMonths.map((month, index) => {
+            return buildNormalMonth(month, yearMonths[index - 1], yearMonths[index + 1]);
+        }),
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Get month                                                                   */
+/* -------------------------------------------------------------------------- */
+/**
+ * Get one Santali month.
+ *
+ * 0  = Magh
+ * 1  = Phagun
+ * 2  = Chaat
+ * ...
+ * 11 = Pus
+ * 12 = Sarcha (leap year only)
+ */
+export function getMonth(year, monthIndex) {
+    if (!Number.isInteger(monthIndex)) {
+        throw new TypeError(`Month index must be an integer: ${monthIndex}`);
+    }
+    const calendarYear = getCalendar(year);
+    const month = calendarYear.months[monthIndex];
+    if (!month) {
+        throw new RangeError(`Invalid Santali month index ${monthIndex} for year ${year}`);
+    }
+    return month;
+}
+/**
+ * Convert a Gregorian date into a Santali date.
+ *
+ * The year is first estimated and then corrected against
+ * the actual generated Santali year boundaries.
+ *
+ * This avoids assuming that every Santali year has the
+ * same number of days.
+ */
+export function getDate(date) {
+    const currentDate = toDate(formatDate(date, "yyyy-MM-dd"));
+    const anchorDate = toDate(YEAR_ANCHOR_DATE);
+    const anchorYear = METONIC_CYCLE_START;
+    const diffDays = differenceInDays(currentDate, anchorDate);
+    /*
+     * Approximation only.
+     *
+     * We use 354 because that is the normal
+     * Santali year length.
+     *
+     * The result is corrected below.
+     */
+    let year = anchorYear + Math.floor(diffDays / 354);
+    let calendarYear = getCalendar(year);
+    /*
+     * If the estimated year is too far ahead,
+     * move backwards.
+     */
+    while (currentDate < toDate(calendarYear.startDate)) {
+        year--;
+        calendarYear = getCalendar(year);
+    }
+    /*
+     * If the estimated year is too far behind,
+     * move forwards.
+     */
+    while (currentDate > toDate(calendarYear.endDate)) {
+        year++;
+        calendarYear = getCalendar(year);
+    }
+    /* ------------------------------------------------------------------------ */
+    /* Find month                                                               */
+    /* ------------------------------------------------------------------------ */
+    for (let monthIndex = 0; monthIndex < calendarYear.months.length; monthIndex++) {
+        const month = calendarYear.months[monthIndex];
+        const monthStart = toDate(month.startDate);
+        const monthEnd = toDate(month.endDate);
+        if (currentDate >= monthStart && currentDate <= monthEnd) {
+            const day = differenceInDays(currentDate, monthStart) + 1;
+            return {
+                day,
+                year,
+                month,
+                monthIndex,
+                monthEndDate: formatDate(monthEnd, "yyyy-MM-dd"),
+                monthStartDate: formatDate(monthStart, "yyyy-MM-dd"),
+                gregorianDate: formatDate(currentDate, "yyyy-MM-dd"),
+            };
+        }
+    }
+    throw new Error(`Could not determine Santali date for ${formatDate(currentDate, "yyyy-MM-dd")}`);
+}
+/* -------------------------------------------------------------------------- */
+/* Today                                                                       */
+/* -------------------------------------------------------------------------- */
+/**
+ * Get today's Santali date.
+ */
+export function getToday() {
+    return getDate(new Date());
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@wesantal/santali-calendar",
+  "version": "1.0.0",
+  "description": "A framework-independent Santali Calendar data and utility package for JavaScript and TypeScript applications.",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "clean": "rimraf dist"
+  },
+  "keywords": [
+    "santali",
+    "calendar",
+    "santali-calendar",
+    "adivasi",
+    "tribal",
+    "indigenous",
+    "india",
+    "jharkhand"
+  ],
+  "author": {
+    "name": "WeSantal",
+    "email": "official.wesantal@gmail.com",
+    "url": "https://wesantal.org"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "~6.0.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "date-fns": "^4.4.0"
+  }
+}