@jenova-marie/sumerian-date 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jenova-marie
+
+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,199 @@
+# sumerian-date
+
+Convert Gregorian dates to the **Nippur Sumerian ritual calendar** as documented by [The Ishtar Gate](https://web.archive.org/web/20250125122100/https://www.theishtargate.com/Calendar/) (archived January 2025).
+
+Pure JavaScript, zero runtime dependencies, works in Node.js 14+.
+
+---
+
+## Background
+
+The Sumerian calendar is a **lunisolar calendar** rooted in the Nippur tradition, the sacred city of Enlil. Each month begins at the first sunset after the astronomical new moon. The year begins with the month whose new moon falls after the vernal equinox. Short years contain 12 months; long years contain 13, following the 19-year Metonic cycle.
+
+Astronomical calculations implement the algorithms of Jean Meeus (*Astronomical Algorithms*, 2nd ed.) for:
+- Vernal equinox (Ch. 27)
+- New moon (Ch. 49)
+- Sunset time for Nippur (32.13°N, 45.23°E by default)
+
+The day-start rule (sunset) is verified against the Ishtar Gate app reference:
+> New moon 8 April 2024 21:20 local (UTC+3) → year start **10 April 2024** ✓
+
+---
+
+## Installation
+
+```bash
+npm install sumerian-date
+```
+
+---
+
+## Quick Start
+
+```javascript
+const { sumerianDate, sumerianYear } = require('sumerian-date');
+
+// Today's Sumerian date
+const today = sumerianDate();
+console.log(today.toString());
+// → "Day 15 of Šekinku — Gregorian 5 Mar 2026"
+
+console.log(today.monthCuneiform);   // 𒌗𒊺𒆥𒋻
+console.log(today.monthMeaning);     // "Reaping of Barley"
+console.log(today.observances);      // [{ name: 'Ešeš', description: '...' }, ...]
+```
+
+---
+
+## API
+
+### `sumerianDate([date], [opts])` → `SumerianDate`
+
+Convert a JS `Date` to its Sumerian equivalent. Defaults to `new Date()` (now).
+
+```javascript
+const sd = sumerianDate(new Date('2024-06-04T15:37:00Z'));
+
+sd.monthName        // "Gusisu"
+sd.monthCuneiform   // "𒌗𒄞𒋛𒁲"
+sd.monthMeaning     // "Marching Forth of Oxen"
+sd.monthDescription // "Beginning of the agricultural season..."
+sd.dayOfMonth       // 27
+sd.monthLengthDays  // 29
+sd.monthStartDate   // Date object
+sd.monthEndDate     // Date object
+sd.cyclePosition    // 18  (position in the 19-year Metonic cycle)
+sd.isIntercalaryYear  // false
+sd.isIntercalaryMonth // false
+sd.observances      // Array of { name, description } for today's observances
+sd.toString()       // "Day 27 of Gusisu — Gregorian 4 Jun 2024"
+```
+
+**opts:**
+| Option | Default | Description |
+|--------|---------|-------------|
+| `latitude` | `32.13` | Reference latitude for sunset (Nippur) |
+| `longitude` | `45.23` | Reference longitude for sunset (Nippur) |
+
+### `sumerianYear([gregorianYear], [opts])` → `SumerianYear`
+
+Get the full year structure including all months with start dates.
+
+```javascript
+const year = sumerianYear(2026);
+
+year.springGregorianYear  // 2026
+year.cyclePosition        // 1  (first year of new 19-year cycle)
+year.isLongYear           // false
+year.yearStart            // Date: ~late March / early April
+year.yearEnd              // Date
+year.nextYearStart        // Date
+
+year.months.forEach(m => {
+  console.log(`${m.number}. ${m.name} — starts ${m.startDate.toDateString()} (${m.lengthDays} days)`);
+});
+// 1. Barazagar — starts Thu Apr 02 2026 (30 days)
+// 2. Gusisu — starts Sat May 02 2026 (29 days)
+// ...
+// 12. Šekinku — starts Mon Feb 22 2027 (29 days)
+```
+
+### `cyclePosition(springGregorianYear)` → `number` (1–19)
+
+Returns the position within the 19-year Metonic cycle.
+Long years (13 months) are at positions: **3, 6, 8, 11, 14, 17, 19**.
+
+```javascript
+cyclePosition(2007)  // 1  — first year of cycle
+cyclePosition(2009)  // 3  — long year (Diri Šekinku appended)
+cyclePosition(2023)  // 17 — long year (Diri Kin Inana inserted after month 6)
+cyclePosition(2026)  // 1  — new cycle begins
+```
+
+### `vernalEquinox(year)` → `Date`
+
+```javascript
+vernalEquinox(2024)  // Thu Mar 20 2024 03:06 UTC
+```
+
+### `nextNewMoon(afterDate)` → `Date`
+
+```javascript
+nextNewMoon(new Date('2024-03-20'))  // Mon Apr 08 2024 18:21 UTC
+```
+
+### `months` — Array of month data
+
+The twelve standard months. Each has:
+- `number` (1–12)
+- `name` — transliteration
+- `cuneiform` — Unicode cuneiform
+- `meaning` — English translation
+- `season`
+- `description`
+- `festivals` — array of `{ day, name, description }`
+
+### `intercalaryMonth` / `intercalaryMonthYear17`
+
+The two intercalary month variants (Diri Šekinku and Diri Kin Inana).
+
+---
+
+## The Twelve Months
+
+| # | Name | 𒀭 | Meaning | Season |
+|---|------|-----|---------|--------|
+| 1 | Barazagar | 𒌗𒁈𒍠𒃻 | Dais of the Sanctuary | Spring |
+| 2 | Gusisu | 𒌗𒄞𒋛𒁲 | Marching Forth of Oxen | Spring |
+| 3 | Sig Ga | 𒌗𒋞𒂵 | Placing of Bricks | Spring |
+| 4 | Šunumun | 𒌗𒋗𒆰𒈾 | Seeding | Summer |
+| 5 | Nenegar | 𒌗𒉈𒉈𒃻 | Lighting of the Braziers | Summer |
+| 6 | Kin Inana | 𒌗𒆥𒀭𒈹 | The Labours of Inana | Summer |
+| 7 | Duku | 𒌗𒇯𒆬 | The Sacred Mound | Autumn |
+| 8 | Apin Dua | 𒌗𒀳𒃮𒀀 | Releasing of the Plough | Autumn |
+| 9 | Gan Gan-e | 𒌗𒃶𒃶𒈾 | Coming of Clouds | Autumn |
+| 10 | Kusu | 𒌗𒆬𒋆 | Lady of the Grain | Autumn |
+| 11 | Uduru | 𒌗𒍩𒀀 | Emmer | Winter |
+| 12 | Šekinku | 𒌗𒊺𒆥𒋻 | Reaping of Barley | Winter |
+| 13* | Diri Šekinku | 𒌗𒋛𒀀𒊺𒆥𒋻 | Second Reaping of Barley | Winter |
+
+*Intercalary month, appended after Šekinku in cycle years 3, 6, 8, 11, 14, 19.
+In cycle year 17, *Diri Kin Inana* is inserted after month 6 instead.
+
+---
+
+## Monthly Observances
+
+Two observances occur every month:
+
+| Day | Name | Description |
+|-----|------|-------------|
+| 7 | **Ešeš** (Quarter Moon) | First-quarter moon; offering to household gods |
+| 15 | **Ešeš** (Full Moon) | Great Offering to all household gods |
+| Last | **Kisiga** (New Moon) | Funerary offerings; libation of fresh water for the dead |
+
+These are returned in `sumerianDate().observances` for the current day.
+
+---
+
+## Calendar Rules (Summary)
+
+1. **Month start**: First sunset after the astronomical new moon (day begins at sunset, per Sumerian custom).
+2. **Year start**: The month whose new moon falls first after the vernal equinox.
+3. **Intercalation**: Metonic 19-year cycle. Years 3, 6, 8, 11, 14, 17, 19 have 13 months. Cycle began spring 2007.
+4. **Month 13 placement**: After month 12 in most long years; after month 6 (as *Diri Kin Inana*) in cycle year 17.
+5. **Reference location**: Nippur (32.13°N, 45.23°E) by default. Override with `opts.latitude` / `opts.longitude`.
+
+---
+
+## Sources
+
+- **The Ishtar Gate** — Ritual Calendar (archived): https://web.archive.org/web/20250125122100/https://www.theishtargate.com/Calendar/
+- Mark E. Cohen, *Cultic Calendars of the Ancient Near East* (CDL Press, 1993)
+- Jean Meeus, *Astronomical Algorithms* (2nd ed., Willmann-Bell, 1998) — Chapters 27 & 49
+
+---
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,577 @@
+"use strict";
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// src/astronomy.js
+var require_astronomy = __commonJS({
+  "src/astronomy.js"(exports2, module2) {
+    "use strict";
+    var DEG = Math.PI / 180;
+    function gregorianToJD(year, month, day) {
+      let y = year;
+      let m = month;
+      if (m <= 2) {
+        y -= 1;
+        m += 12;
+      }
+      const A = Math.floor(y / 100);
+      const B = 2 - A + Math.floor(A / 4);
+      return Math.floor(365.25 * (y + 4716)) + Math.floor(30.6001 * (m + 1)) + day + B - 1524.5;
+    }
+    function jdToGregorian2(jd) {
+      const z = Math.floor(jd + 0.5);
+      const f = jd + 0.5 - z;
+      let A;
+      if (z < 2299161) {
+        A = z;
+      } else {
+        const alpha = Math.floor((z - 186721625e-2) / 36524.25);
+        A = z + 1 + alpha - Math.floor(alpha / 4);
+      }
+      const B = A + 1524;
+      const C = Math.floor((B - 122.1) / 365.25);
+      const D = Math.floor(365.25 * C);
+      const E = Math.floor((B - D) / 30.6001);
+      const dayFrac = B - D - Math.floor(30.6001 * E) + f;
+      const day = Math.floor(dayFrac);
+      const month = E < 14 ? E - 1 : E - 13;
+      const year = month > 2 ? C - 4716 : C - 4715;
+      const fracDay = dayFrac - day;
+      const hour = Math.floor(fracDay * 24);
+      const fracHour = fracDay * 24 - hour;
+      const minute = Math.floor(fracHour * 60);
+      const second = Math.round((fracHour * 60 - minute) * 60);
+      return { year, month, day, hour, minute, second };
+    }
+    function vernalEquinoxJDE2(year) {
+      let JDE0;
+      if (year >= 1e3) {
+        const Y = (year - 2e3) / 1e3;
+        JDE0 = 245162380984e-5 + 365242.37404 * Y + 0.05169 * Y * Y - 411e-5 * Y * Y * Y - 57e-5 * Y * Y * Y * Y;
+      } else {
+        const Y = year / 1e3;
+        JDE0 = 17211392855e-4 + 365242.1376 * Y + 0.06679 * Y * Y - 669e-5 * Y * Y * Y;
+      }
+      const T = (JDE0 - 2451545) / 36525;
+      const W = 35999.373 * T - 2.47;
+      const dL = 1 + 0.0334 * Math.cos(W * DEG) + 7e-4 * Math.cos(2 * W * DEG);
+      const corrections = [
+        [485, 324.96, 1934.136],
+        [203, 337.23, 32964.467],
+        [199, 342.08, 20.186],
+        [182, 27.85, 445267.112],
+        [156, 73.14, 45036.886],
+        [136, 171.52, 22518.443],
+        [77, 222.54, 65928.934],
+        [74, 296.72, 3034.906],
+        [70, 243.58, 9037.513],
+        [58, 119.81, 33718.147],
+        [52, 297.17, 150.678],
+        [50, 21.02, 2281.226],
+        [45, 247.54, 29929.562],
+        [44, 325.15, 31555.956],
+        [29, 60.93, 4443.417],
+        [18, 155.12, 67555.328],
+        [17, 288.79, 4562.452],
+        [16, 198.04, 62894.029],
+        [14, 199.76, 31557.381],
+        [12, 95.39, 14577.848],
+        [10, 49.69, 31557.381],
+        [9, 162.03, 31557.381],
+        [9, 35.47, 1222.114],
+        [9, 32.43, 1191.013],
+        [9, 36.4, 1232.124],
+        [9, 57.03, 1229.225]
+      ];
+      const S = corrections.reduce((sum, [a, b, c]) => sum + a * Math.cos(DEG * (b + c * T)), 0);
+      return JDE0 + 1e-5 * S / dL;
+    }
+    function newMoonJDE(k) {
+      const T = k / 1236.85;
+      const T2 = T * T;
+      const T3 = T2 * T;
+      const T4 = T3 * T;
+      let JDE = 245155009766e-5 + 29.530588861 * k + 15437e-8 * T2 - 15e-8 * T3 + 73e-11 * T4;
+      const E = 1 - 2516e-6 * T - 74e-7 * T2;
+      const M = (2.5534 + 29.1053567 * k - 14e-7 * T2 - 11e-8 * T3) * DEG;
+      const Mp = (201.5643 + 385.81693528 * k + 0.0107582 * T2 + 1238e-8 * T3 - 58e-9 * T4) * DEG;
+      const F = (160.7108 + 390.67050284 * k - 16118e-7 * T2 - 227e-8 * T3 + 11e-9 * T4) * DEG;
+      const Om = (124.7746 - 1.56375588 * k + 20672e-7 * T2 + 215e-8 * T3) * DEG;
+      JDE += -0.4072 * Math.sin(Mp) + 0.17241 * E * Math.sin(M) + 0.01608 * Math.sin(2 * Mp) + 0.01039 * Math.sin(2 * F) + 739e-5 * E * Math.sin(Mp - M) - 514e-5 * E * Math.sin(Mp + M) + 208e-5 * E * E * Math.sin(2 * M) - 111e-5 * Math.sin(Mp - 2 * F) - 57e-5 * Math.sin(Mp + 2 * F) + 56e-5 * E * Math.sin(2 * Mp + M) - 42e-5 * Math.sin(3 * Mp) + 42e-5 * E * Math.sin(M + 2 * F) + 38e-5 * E * Math.sin(M - 2 * F) - 24e-5 * E * Math.sin(2 * Mp - M) - 17e-5 * Math.sin(Om) - 7e-5 * Math.sin(Mp + 2 * M) + 4e-5 * Math.sin(2 * Mp - 2 * F) + 4e-5 * Math.sin(3 * M) + 3e-5 * Math.sin(Mp + M - 2 * F) + 3e-5 * Math.sin(2 * Mp + 2 * F) - 3e-5 * Math.sin(Mp + M + 2 * F) + 3e-5 * Math.sin(Mp - M + 2 * F) - 2e-5 * Math.sin(Mp - M - 2 * F) - 2e-5 * Math.sin(3 * Mp + M) + 2e-5 * Math.sin(4 * Mp);
+      return JDE;
+    }
+    function kNearJDE(jde) {
+      return (jde - 245155009766e-5) / 29.530588861;
+    }
+    function firstNewMoonAfter2(afterJDE) {
+      let k = Math.ceil(kNearJDE(afterJDE));
+      let nm = newMoonJDE(k);
+      while (nm <= afterJDE + 0.01) {
+        k++;
+        nm = newMoonJDE(k);
+      }
+      return nm;
+    }
+    function sunsetUTHour(jdNoon, latitude, longitude) {
+      const lngHour = longitude / 15;
+      const { year, month, day } = jdToGregorian2(jdNoon);
+      const N = Math.floor(275 * month / 9) - 2 * Math.floor((month + 9) / 12) + day - 30;
+      const t = N + (18 - lngHour) / 24;
+      const M = (0.9856 * t - 3.289) % 360;
+      let L = M + 1.916 * Math.sin(M * DEG) + 0.02 * Math.sin(2 * M * DEG) + 282.634;
+      L = (L % 360 + 360) % 360;
+      let RA = (Math.atan(0.91764 * Math.tan(L * DEG)) / DEG + 360) % 360;
+      const Lq = Math.floor(L / 90) * 90;
+      const RAq = Math.floor(RA / 90) * 90;
+      RA = (RA + Lq - RAq) / 15;
+      const sinDec = 0.39782 * Math.sin(L * DEG);
+      const cosDec = Math.cos(Math.asin(sinDec));
+      const cosH = (Math.cos(90.833 * DEG) - sinDec * Math.sin(latitude * DEG)) / (cosDec * Math.cos(latitude * DEG));
+      if (cosH > 1) return null;
+      if (cosH < -1) return null;
+      const H = Math.acos(cosH) / DEG / 15;
+      let T = H + RA - 0.06571 * t - 6.622;
+      let UT = T - lngHour;
+      return (UT % 24 + 24) % 24;
+    }
+    module2.exports = {
+      gregorianToJD,
+      jdToGregorian: jdToGregorian2,
+      vernalEquinoxJDE: vernalEquinoxJDE2,
+      newMoonJDE,
+      firstNewMoonAfter: firstNewMoonAfter2,
+      sunsetUTHour,
+      kNearJDE
+    };
+  }
+});
+
+// src/months.js
+var require_months = __commonJS({
+  "src/months.js"(exports2, module2) {
+    "use strict";
+    var MONTHS2 = [
+      {
+        number: 1,
+        name: "Barazagar",
+        cuneiform: "\u{12317}\u{12048}\u{12360}\u{120FB}",
+        meaning: "Dais of the Sanctuary",
+        season: "spring",
+        description: "New Year. The throne-dais of Enlil at the E-kur temple of Nippur. The zagmuk (akitu) New Year festival begins, commemorating the bond between humanity and the gods.",
+        festivals: [
+          { day: 1, name: "Zagmuk (New Year / Akitu)", description: "Multi-day New Year festival begins." },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering to all household gods." }
+        ]
+      },
+      {
+        number: 2,
+        name: "Gusisu",
+        cuneiform: "\u{12317}\u{1211E}\u{122DB}\u{12072}",
+        meaning: "Marching Forth of Oxen",
+        season: "spring",
+        description: "Beginning of the agricultural season. Sacred to Ninurta, Lord of the Plough. A time to prepare resources and reflect on intentions set at New Year.",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "First-quarter moon offering." },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." },
+          { day: 20, name: "Ezem Gusisu (Day 1)", description: "Three-day Festival of Marching Oxen begins." },
+          { day: 21, name: "Ezem Gusisu (Day 2)", description: "" },
+          { day: 22, name: "Ezem Gusisu (Day 3)", description: "Ninurta receives highest honours." }
+        ]
+      },
+      {
+        number: 3,
+        name: "Sig Ga",
+        cuneiform: "\u{12317}\u{122DE}\u{120B5}",
+        meaning: "Placing of Bricks",
+        season: "spring",
+        description: "Labour of the cities and making of mud bricks. A time to lay firm foundations. Holy days sacred to the brick god Kulla.",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." }
+        ]
+      },
+      {
+        number: 4,
+        name: "\u0160unumun",
+        cuneiform: "\u{12317}\u{122D7}\u{121B0}\u{1223E}",
+        meaning: "Seeding",
+        season: "summer",
+        description: "Ceremonial onset of the seeding season; fields prepared by weeding. Month of ritual mourning for Dumuzi (Tammuz), consort of Inana, who descends to the Underworld for six months.",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." },
+          { day: null, name: "Mourning of Dumuzi", description: "Ritual mourning for Dumuzi throughout the month." }
+        ]
+      },
+      {
+        number: 5,
+        name: "Nenegar",
+        cuneiform: "\u{12317}\u{12248}\u{12248}\u{120FB}",
+        meaning: "Lighting of the Braziers",
+        season: "summer",
+        description: "Height of the Mesopotamian summer. The worlds of the living and dead are most closely connected. Fires lit as invitation to and protection from spirits of the dead.",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." },
+          { day: 27, name: "Festival of Spirits", description: "Braziers lit; ceremonial meal with the dead; offerings to chthonic deities and gods of the Underworld." }
+        ]
+      },
+      {
+        number: 6,
+        name: "Kin Inana",
+        cuneiform: "\u{12317}\u{121A5}\u{1202D}\u{12239}",
+        meaning: "The Labours of Inana",
+        season: "summer",
+        description: "Month-long celebration and adoration of Inana. Her statue is adorned and processed to the temples of Enlil and Nanna. The second half recreates Inana's Descent to the Underworld and triumphant return.",
+        festivals: [
+          { day: 1, name: "Adornment of Inana", description: "Inana's statue robed in jewellery and divine icons." },
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon) / Great Offering of Inana", description: "Peak of the month's festivities." },
+          { day: 21, name: "Return of Inana", description: "Statues ceremonially bathed and re-invested." },
+          { day: 26, name: "Inana's Glory", description: "Further offerings; recitations of myths of Inana's power." }
+        ]
+      },
+      {
+        number: 7,
+        name: "Duku",
+        cuneiform: "\u{12317}\u{121EF}\u{121AC}",
+        meaning: "The Sacred Mound",
+        season: "autumn",
+        description: "Second half of the year begins with its own akitu festival. The Sacred Mound is where earth first emerged from the primordial waters and life was first created. The seventh day of the seventh month is a day to petition the gods for peace and vitality.",
+        festivals: [
+          { day: 1, name: "Akitu (Autumnal)", description: "Second half-year festival; honouring primordial ancestors." },
+          { day: 7, name: "Petition Day / E\u0161e\u0161", description: "Petition the gods for peace, health, and vitality." },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." }
+        ]
+      },
+      {
+        number: 8,
+        name: "Apin Dua",
+        cuneiform: "\u{12317}\u{12033}\u{120EE}\u{12000}",
+        meaning: "Releasing of the Plough",
+        season: "autumn",
+        description: "The plough is put away; seeding is complete and the harvest awaited. A time to check milestones and tie off loose ends. Cities of Ur, Isin, Larsa, and Adab also celebrate a Festival of Spirits this month.",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." }
+        ]
+      },
+      {
+        number: 9,
+        name: "Gan Gan-e",
+        cuneiform: "\u{12317}\u{120F6}\u{120F6}\u{1223E}",
+        meaning: "Coming of Clouds",
+        season: "autumn",
+        description: "Start of the growing season; clouds appear over the plain of Sumer. Sacred to the storm god I\u0161kur. A time of anticipation and perseverance.",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." },
+          { day: 28, name: "Festival of Clouds", description: "Offerings to I\u0161kur, god of storms." }
+        ]
+      },
+      {
+        number: 10,
+        name: "Kusu",
+        cuneiform: "\u{12317}\u{121AC}\u{122C6}",
+        meaning: "Lady of the Grain",
+        season: "autumn",
+        description: "Named for Ezina-Kusu, grain goddess of Nippur, associated with Nisaba. The amber waves of grain approach full height. A time of preparation for the imminent harvest. (Also known as Abbe after c. 2000 BCE at Nippur.)",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." }
+        ]
+      },
+      {
+        number: 11,
+        name: "Uduru",
+        cuneiform: "\u{12317}\u{12369}\u{12000}",
+        meaning: "Emmer",
+        season: "winter",
+        description: "The harvest season begins in earnest. Emmer and barley \u2014 principal crops of Sumer \u2014 are reaped. The work of the year comes to a close.",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." }
+        ]
+      },
+      {
+        number: 12,
+        name: "\u0160ekinku",
+        cuneiform: "\u{12317}\u{122BA}\u{121A5}\u{122FB}",
+        meaning: "Reaping of Barley",
+        season: "winter",
+        description: "Culmination of the year. The barley harvest \u2014 high point of the Sumerian agricultural cycle \u2014 is celebrated with great hope and joy. Contains the vernal equinox, after which the new year begins.",
+        festivals: [
+          { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+          { day: 15, name: "Festival of Barley / E\u0161e\u0161 (Full Moon)", description: "Honour, offerings, and praise given to Enlil and Ezina." }
+        ]
+      }
+    ];
+    var DIRI_\u0160EKINKU2 = {
+      number: 13,
+      name: "Diri \u0160ekinku",
+      cuneiform: "\u{12317}\u{122DB}\u{12000}\u{122BA}\u{121A5}\u{122FB}",
+      meaning: "Second Reaping of Barley",
+      season: "winter",
+      intercalary: true,
+      description: "Intercalary month; observations mirror those of \u0160ekinku.",
+      festivals: [
+        { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+        { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." }
+      ]
+    };
+    var DIRI_KIN_INANA2 = {
+      number: 7,
+      // inserted before standard month 7 (Duku)
+      name: "Diri Kin Inana",
+      cuneiform: null,
+      // not attested in the source document
+      meaning: "Second Labours of Inana",
+      season: "summer",
+      intercalary: true,
+      description: "Intercalary month in cycle year 17 only; inserted after Kin Inana. Observations likely mirror those of Kin Inana.",
+      festivals: [
+        { day: 7, name: "E\u0161e\u0161 (Quarter Moon)", description: "" },
+        { day: 15, name: "E\u0161e\u0161 (Full Moon)", description: "Great Offering." }
+      ]
+    };
+    module2.exports = { MONTHS: MONTHS2, DIRI_\u0160EKINKU: DIRI_\u0160EKINKU2, DIRI_KIN_INANA: DIRI_KIN_INANA2 };
+  }
+});
+
+// src/calendar.js
+var require_calendar = __commonJS({
+  "src/calendar.js"(exports2, module2) {
+    "use strict";
+    var {
+      gregorianToJD,
+      jdToGregorian: jdToGregorian2,
+      vernalEquinoxJDE: vernalEquinoxJDE2,
+      firstNewMoonAfter: firstNewMoonAfter2,
+      sunsetUTHour
+    } = require_astronomy();
+    var { MONTHS: MONTHS2, DIRI_\u0160EKINKU: DIRI_\u0160EKINKU2, DIRI_KIN_INANA: DIRI_KIN_INANA2 } = require_months();
+    var LONG_YEAR_POSITIONS = /* @__PURE__ */ new Set([3, 6, 8, 11, 14, 17, 19]);
+    var CYCLE_EPOCH_GREGORIAN_YEAR = 2007;
+    function getCyclePosition2(springYear) {
+      const offset = ((springYear - CYCLE_EPOCH_GREGORIAN_YEAR) % 19 + 19) % 19;
+      return offset + 1;
+    }
+    function buildMonthSequence(cyclePosition2) {
+      const isLong = LONG_YEAR_POSITIONS.has(cyclePosition2);
+      if (!isLong) {
+        return MONTHS2.slice(0, 12).map((m) => ({ ...m }));
+      }
+      if (cyclePosition2 === 17) {
+        const seq = [];
+        for (let i = 0; i < 12; i++) {
+          const m = { ...MONTHS2[i] };
+          if (i >= 6) m.number = i + 2;
+          seq.push(m);
+          if (i === 5) {
+            seq.push({ ...DIRI_KIN_INANA2, number: 7 });
+          }
+        }
+        return seq;
+      }
+      return [
+        ...MONTHS2.slice(0, 12).map((m) => ({ ...m })),
+        { ...DIRI_\u0160EKINKU2 }
+      ];
+    }
+    var NIPPUR_LAT = 32.13;
+    var NIPPUR_LON = 45.23;
+    function monthStartDate(nmJDE, latitude = NIPPUR_LAT, longitude = NIPPUR_LON) {
+      const g = jdToGregorian2(nmJDE);
+      const jdNoon = gregorianToJD(g.year, g.month, g.day);
+      const sunsetUT = sunsetUTHour(jdNoon, latitude, longitude);
+      const nmUTHour = (nmJDE - jdNoon) * 24 + 12;
+      const effectiveSunset = sunsetUT !== null ? sunsetUT : 18;
+      const daysToAdd = nmUTHour < effectiveSunset ? 1 : 2;
+      const start = new Date(Date.UTC(g.year, g.month - 1, g.day));
+      start.setUTCDate(start.getUTCDate() + daysToAdd);
+      return start;
+    }
+    function computeSumerianYear2(springGregorianYear, opts = {}) {
+      const lat = opts.latitude ?? NIPPUR_LAT;
+      const lon = opts.longitude ?? NIPPUR_LON;
+      const cyclePosition2 = getCyclePosition2(springGregorianYear);
+      const monthSequence = buildMonthSequence(cyclePosition2);
+      const isLongYear = LONG_YEAR_POSITIONS.has(cyclePosition2);
+      const veJDE = vernalEquinoxJDE2(springGregorianYear);
+      const yearNmJDE = firstNewMoonAfter2(veJDE);
+      const yearStart = monthStartDate(yearNmJDE, lat, lon);
+      let searchAfterJDE = yearNmJDE - 0.5;
+      const months2 = [];
+      for (let i = 0; i < monthSequence.length; i++) {
+        const nm = i === 0 ? yearNmJDE : firstNewMoonAfter2(searchAfterJDE);
+        const start = i === 0 ? yearStart : monthStartDate(nm, lat, lon);
+        months2.push({
+          ...monthSequence[i],
+          startDate: start,
+          newMoonJDE: nm
+        });
+        searchAfterJDE = nm;
+      }
+      const nextYearVeJDE = vernalEquinoxJDE2(springGregorianYear + 1);
+      const nextYearNmJDE = firstNewMoonAfter2(nextYearVeJDE);
+      const nextYearStart = monthStartDate(nextYearNmJDE, lat, lon);
+      for (let i = 0; i < months2.length; i++) {
+        const nextStart = i + 1 < months2.length ? months2[i + 1].startDate : nextYearStart;
+        const msMs = months2[i].startDate.getTime();
+        const nxMs = nextStart.getTime();
+        months2[i].endDate = new Date(nxMs - 864e5);
+        months2[i].lengthDays = Math.round((nxMs - msMs) / 864e5);
+      }
+      return {
+        springGregorianYear,
+        cyclePosition: cyclePosition2,
+        isLongYear,
+        yearStart,
+        yearEnd: new Date(nextYearStart.getTime() - 864e5),
+        nextYearStart,
+        months: months2,
+        vernalEquinoxJDE: veJDE,
+        /** Gregorian date of the vernal equinox */
+        get vernalEquinoxDate() {
+          const g = jdToGregorian2(veJDE);
+          return new Date(Date.UTC(g.year, g.month - 1, g.day));
+        }
+      };
+    }
+    function toSumerianDate2(date, opts = {}) {
+      if (!(date instanceof Date)) {
+        opts = date || {};
+        date = /* @__PURE__ */ new Date();
+      }
+      const gregorianYear = date.getUTCFullYear();
+      const candidates = [gregorianYear, gregorianYear - 1, gregorianYear + 1];
+      let sYear = null;
+      for (const candidate of candidates) {
+        const sy = computeSumerianYear2(candidate, opts);
+        if (date >= sy.yearStart && date < sy.nextYearStart) {
+          sYear = sy;
+          break;
+        }
+      }
+      if (!sYear) {
+        throw new Error(`Could not determine Sumerian year for ${date.toISOString()}`);
+      }
+      let monthObj = null;
+      let dayOfMonth = null;
+      for (let i = 0; i < sYear.months.length; i++) {
+        const m = sYear.months[i];
+        const next = i + 1 < sYear.months.length ? sYear.months[i + 1].startDate : sYear.nextYearStart;
+        if (date >= m.startDate && date < next) {
+          monthObj = m;
+          dayOfMonth = Math.floor((date - m.startDate) / 864e5) + 1;
+          break;
+        }
+      }
+      if (!monthObj) {
+        throw new Error(`Could not determine Sumerian month for ${date.toISOString()}`);
+      }
+      const observances = [];
+      if (dayOfMonth === 7) {
+        observances.push({ name: "E\u0161e\u0161", description: "First-quarter moon offering to all household gods." });
+      }
+      if (dayOfMonth === 15) {
+        observances.push({ name: "E\u0161e\u0161", description: "Full moon \u2014 Great Offering to all household gods." });
+      }
+      if (dayOfMonth === monthObj.lengthDays) {
+        observances.push({ name: "Kisiga", description: "New moon \u2014 Funerary offerings and libations for the beloved dead." });
+      }
+      (monthObj.festivals || []).forEach((f) => {
+        if (f.day === dayOfMonth) observances.push(f);
+      });
+      return {
+        gregorianDate: date,
+        springGregorianYear: sYear.springGregorianYear,
+        cyclePosition: sYear.cyclePosition,
+        monthNumber: monthObj.number,
+        monthName: monthObj.name,
+        monthCuneiform: monthObj.cuneiform,
+        monthMeaning: monthObj.meaning,
+        monthDescription: monthObj.description,
+        dayOfMonth,
+        monthLengthDays: monthObj.lengthDays,
+        monthStartDate: monthObj.startDate,
+        monthEndDate: monthObj.endDate,
+        isIntercalaryYear: sYear.isLongYear,
+        isIntercalaryMonth: !!monthObj.intercalary,
+        observances,
+        sumerianYear: sYear,
+        toString() {
+          const g = date;
+          const months2 = [
+            "Jan",
+            "Feb",
+            "Mar",
+            "Apr",
+            "May",
+            "Jun",
+            "Jul",
+            "Aug",
+            "Sep",
+            "Oct",
+            "Nov",
+            "Dec"
+          ];
+          return `Day ${dayOfMonth} of ${monthObj.name} \u2014 Gregorian ${g.getUTCDate()} ${months2[g.getUTCMonth()]} ${g.getUTCFullYear()}`;
+        }
+      };
+    }
+    module2.exports = {
+      computeSumerianYear: computeSumerianYear2,
+      toSumerianDate: toSumerianDate2,
+      getCyclePosition: getCyclePosition2,
+      LONG_YEAR_POSITIONS,
+      NIPPUR_LAT,
+      NIPPUR_LON
+    };
+  }
+});
+
+// src/index.js
+var { toSumerianDate, computeSumerianYear, getCyclePosition } = require_calendar();
+var { MONTHS, DIRI_\u0160EKINKU, DIRI_KIN_INANA } = require_months();
+var { vernalEquinoxJDE, firstNewMoonAfter, jdToGregorian } = require_astronomy();
+function sumerianDate(date, opts) {
+  return toSumerianDate(date, opts);
+}
+function sumerianYear(gregorianYear, opts) {
+  if (typeof gregorianYear !== "number") {
+    opts = gregorianYear;
+    gregorianYear = (/* @__PURE__ */ new Date()).getUTCFullYear();
+  }
+  return computeSumerianYear(gregorianYear, opts || {});
+}
+function cyclePosition(springGregorianYear) {
+  return getCyclePosition(springGregorianYear);
+}
+function vernalEquinox(year) {
+  const jde = vernalEquinoxJDE(year);
+  const g = jdToGregorian(jde);
+  return new Date(Date.UTC(g.year, g.month - 1, g.day, g.hour, g.minute));
+}
+function nextNewMoon(afterDate) {
+  const jdEpoch = 24405875e-1;
+  const afterJDE = jdEpoch + afterDate.getTime() / 864e5;
+  const nmJDE = firstNewMoonAfter(afterJDE);
+  const g = jdToGregorian(nmJDE);
+  return new Date(Date.UTC(g.year, g.month - 1, g.day, g.hour, g.minute));
+}
+var months = MONTHS;
+var intercalaryMonth = DIRI_\u0160EKINKU;
+var intercalaryMonthYear17 = DIRI_KIN_INANA;
+module.exports = {
+  sumerianDate,
+  sumerianYear,
+  cyclePosition,
+  vernalEquinox,
+  nextNewMoon,
+  months,
+  intercalaryMonth,
+  intercalaryMonthYear17
+};

package/dist/index.mjs

@@ -0,0 +1,10 @@
+import mod from './index.cjs';
+export const sumerianDate = mod.sumerianDate;
+export const sumerianYear = mod.sumerianYear;
+export const cyclePosition = mod.cyclePosition;
+export const vernalEquinox = mod.vernalEquinox;
+export const nextNewMoon = mod.nextNewMoon;
+export const months = mod.months;
+export const intercalaryMonth = mod.intercalaryMonth;
+export const intercalaryMonthYear17 = mod.intercalaryMonthYear17;
+export default mod;

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@jenova-marie/sumerian-date",
+  "version": "0.1.0",
+  "description": "Convert Gregorian dates to the Nippur Sumerian ritual calendar",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "node build.js",
+    "test": "node test/index.test.js",
+    "prepublishOnly": "npm test && npm run build"
+  },
+  "keywords": [
+    "sumerian",
+    "calendar",
+    "nippur",
+    "lunisolar",
+    "metonic",
+    "ancient",
+    "mesopotamia",
+    "date",
+    "astronomy"
+  ],
+  "author": "jenova-marie",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jenova-marie/sumerian-date.git"
+  },
+  "engines": {
+    "node": ">=14"
+  },
+  "devDependencies": {
+    "esbuild": "^0.27.3"
+  }
+}