ponomar-ts 0.2.0-alpha.0 → 1.0.0-rc.0

package/README.md

@@ -2,9 +2,11 @@
 
 A TypeScript port of the [Ponomar](https://github.com/typiconman/ponomar) Orthodox liturgics engine.
 
-> [!WARNING]
-> **Status: pre-alpha.** Nothing works yet. This repository contains scaffolding
-> and the beginnings of a paschal-date module. Do not depend on it for anything.
+> [!NOTE]
+> **Status: 1.0 release candidate.** The engine is feature-complete against
+> the ported subset of upstream Ponomar and covered by 305 tests. Public API
+> is frozen for 1.0. Consumers should pin to `^1.0.0-rc` while the release
+> soaks; the plain `1.0.0` tag will follow once no blocking issues surface.
 
 ## What this is
 
@@ -14,38 +16,50 @@ liturgical information (saints, readings, tone, fasting, feast transfer rules)
 by following the Orthodox Typicon precisely, driven by declarative XML data
 files that encode each day's rubrics.
 
-**ponomar-ts** aims to be a faithful port of the *engine and the data* to
-TypeScript, so it can be consumed by modern JS/TS applications (Node servers,
-Next.js apps, mobile React Native builds) without a JVM or a desktop UI.
+**ponomar-ts** is a faithful port of the *engine and the data* to TypeScript,
+so it can be consumed by modern JS/TS applications (Node servers, Next.js
+apps, mobile React Native builds) without a JVM or a desktop UI.
 
 ### Scope
 
 Ported:
 
-- [ ] Paschalion (Meeus' luni-solar algorithm; Julian → Gregorian conversion)
-- [ ] Day / Days aggregate
-- [ ] Commemoration selection & feast-rank transfers
-- [ ] Gospel / Epistle pericope resolution (including Lukan Jump and reserves)
-- [ ] Oktoechos tone rotation
-- [ ] Fasting rule classification
-- [ ] XML data loader for the Ponomar `languages/` corpus
-
-Not in scope (left to the original Java project):
+- [x] **Paschalion** — Meeus' luni-solar algorithm; Julian ↔ Gregorian conversion
+- [x] **Julian date math** — `JDate` value type, day-of-week, addition, difference
+- [x] **StringOp DSL** — lexer + Pratt parser + evaluator for `Cmd=` / `Value=` rule expressions
+- [x] **Day composition** — `getLiturgicalDay(date)` → paschal + menaion saints, `dRank`, tone
+- [x] **Commemoration metadata** — names, ranks, biographical info, and life prose (English)
+- [x] **Gospel / Epistle readings** — `getDailyReadings` (raw) and `getOrderedLiturgyReadings` (Suppress + Class3Transfers + Saturday inversion + cross-day pull)
+- [x] **Matins reading conflict resolution** — Sunday festal-vs-sequential arbitration
+- [x] **Fasting rules** — `getFasting(date)` → 9 canonical levels + per-food-group permissions
+- [x] **Service selection** — Little Hours template dispatch per period rules
+- [x] **Service composition** — typed directive streams for every static template under `languages/xml/Services/`
+- [x] **Hymn propers** — `getPropers(date)` → troparia + kontakia per commemoration
+- [x] **Phrase text** — 283 static phrases (CommonPrayers / Text / Header / Command), English
+- [x] **Bible reference parser** — 1169/1170 upstream refs parse cleanly (one is an upstream typo)
+- [x] **Astronomy** — sunrise/sunset (SUNRISET.C) + Metonic-cycle lunar phase
+
+Not in scope (left to the original Java project or to consumers):
 
 - Swing desktop UI
 - Font rendering and Church Slavonic typography
-- Full service assembly (Matins, Hours, Divine Liturgy)
+- Localization (engine returns raw IDs; consumers handle i18n)
+- Bible text (only reference metadata ships; text is per-locale)
 - Icon display
 - Liturgical music library
 
-## Installation
+See [PLAN.md](PLAN.md) for phase-by-phase implementation notes and the
+"Known limitations" section for documented deviations from upstream.
 
-Not yet published. Once released:
+## Installation
 
 ```bash
-npm install ponomar-ts
+npm install ponomar-ts@next
 ```
 
+The `next` dist-tag tracks the 1.0 release candidates. Once `1.0.0` ships,
+plain `npm install ponomar-ts` will resolve to it.
+
 ## Development
 
 The upstream Ponomar Java repo is vendored as a git submodule under
@@ -54,25 +68,73 @@ at build time by `scripts/codegen/`. The compiled library ships no XML and
 has no XML parser at runtime.
 
 ```powershell
-git clone https://github.com/Wolftrail/ponomar-ts.git
+git clone https://github.com/wolfgangnothdurft/ponomar-ts.git
 cd ponomar-ts
 git submodule update --init --recursive
 npm install
-npm run codegen      # regenerate src/data/ from vendor/ (once codegen lands)
+npm run codegen      # regenerate src/data/ from vendor/
 npm run typecheck
 npm test
+npm run build
 ```
 
-See [PLAN.md](PLAN.md) for the port roadmap and phase breakdown.
+See [PLAN.md](PLAN.md) for the port roadmap and phase breakdown, and
+[CHANGELOG.md](CHANGELOG.md) for per-release notes.
 
 ## Usage
 
+The public API takes plain `CalendarDate` literals (`{ year, month, day }`)
+rather than JS `Date` objects, so the same code runs identically in Node,
+the browser, and time-zone-sensitive contexts.
+
 ```ts
-// Preview API — subject to change.
-import { getOrthodoxPascha } from "ponomar-ts/paschalion";
+import {
+  getOrthodoxPascha,
+  getLiturgicalDay,
+  getOrderedLiturgyReadings,
+  getFasting,
+  getHourService,
+  parseBibleRef,
+} from "ponomar-ts";
+
+// Paschal date for a Gregorian year
+getOrthodoxPascha(2026);
+// → { year: 2026, month: 4, day: 12 }
+
+// Full liturgical day: paschal + menaion saints, dRank, tone
+const day = getLiturgicalDay({ year: 2024, month: 1, day: 7 }); // Nativity (Old Calendar)
+day.dRank;                         // 7 (Great Feast of the Lord)
+day.allSaints[1]?.name?.short;     // "Nativity"
+
+// Divine Liturgy readings — canonical order, with Suppress + Class3Transfers
+const readings = getOrderedLiturgyReadings({ year: 2024, month: 1, day: 7 });
+readings.apostol.map(r => r.reading); // ["Gal_4:4-7"]
+readings.gospel.map(r => r.reading);  // ["Mt_2:1-12"]
+
+// Fasting rule for a date
+const fast = getFasting({ year: 2024, month: 3, day: 22 }); // Lenten Friday
+fast.level;                  // "no-oil"
+fast.permitted.meat;         // false
+fast.permitted.oil;          // false
+
+// Little Hour template dispatch (Prime, Terce, Sexte, None)
+const prime = getHourService({ year: 2024, month: 4, day: 2 }, "prime");
+prime.templateName;   // "Prime"
+prime.PFlag2;         // 1 (auto-derived: Lenten)
+
+// Bible reference parser (78 books, 163 aliases)
+parseBibleRef("I Tim_3:14-4:5");
+// → { book: "I_Tim", bookLabel: "I Tim", ranges: [{ start, end }] }
+```
+
+Deep imports are encouraged when bundle size matters:
 
-const pascha = getOrthodoxPascha(2026);
-// -> { year: 2026, month: 4, day: 19 }
+```ts
+import { getOrthodoxPascha } from "ponomar-ts/paschalion";
+import { getFasting } from "ponomar-ts/engine";
+import { parseBibleRef } from "ponomar-ts/bible";
+import { getSunriseSunset, getLunarPhase } from "ponomar-ts/astronomy";
+import { getLife } from "ponomar-ts/lives"; // life prose, ~1.6 MB payload
 ```
 
 ## Design goals

package/dist/astronomy/index.d.ts

@@ -0,0 +1,5 @@
+export { SunAltitude, formatClock, getSunriseSunset, } from "./sunrise.ts";
+export type { SunriseSunsetOptions, SunriseSunsetResult, } from "./sunrise.ts";
+export { LUNAR_MONTH, LUNAR_HALF_DAY, getLunarCycle, getLunarPhase, getLunarPhaseName, getNextNewMoon, getNextFullMoon, } from "./lunar.ts";
+export type { LunarPhaseName } from "./lunar.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/astronomy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/astronomy/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,WAAW,EACX,WAAW,EACX,gBAAgB,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACX,oBAAoB,EACpB,mBAAmB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/astronomy/index.js

@@ -0,0 +1,6 @@
+// Standalone astronomy helpers — sunrise/sunset and Metonic-cycle lunar
+// phase. Ported from Ponomar/Sunrise.java and the lunar-phase paths in
+// Ponomar/Paschalion.java.
+export { SunAltitude, formatClock, getSunriseSunset, } from "./sunrise.js";
+export { LUNAR_MONTH, LUNAR_HALF_DAY, getLunarCycle, getLunarPhase, getLunarPhaseName, getNextNewMoon, getNextFullMoon, } from "./lunar.js";
+//# sourceMappingURL=index.js.map

package/dist/astronomy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/astronomy/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,uEAAuE;AACvE,2BAA2B;AAE3B,OAAO,EACN,WAAW,EACX,WAAW,EACX,gBAAgB,GAChB,MAAM,cAAc,CAAC;AAKtB,OAAO,EACN,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAC"}

package/dist/astronomy/lunar.d.ts

@@ -0,0 +1,22 @@
+import type { JulianDate } from "../core/calendar/jdate.ts";
+/** Mean synodic month, in days. Upstream constant. */
+export declare const LUNAR_MONTH = 29.52916667;
+/** Half a lunar "day" — the window around each cardinal phase within
+ *  which {@link getLunarPhaseName} rounds to that phase. */
+export declare const LUNAR_HALF_DAY = 0.016932411;
+/** Names for the eight cardinal lunar phases. */
+export type LunarPhaseName = "new" | "waxing-crescent" | "first-quarter" | "waxing-gibbous" | "full" | "waning-gibbous" | "last-quarter" | "waning-crescent";
+/** Metonic-cycle index (1..19) for a Julian-calendar year (AD 33 or later). */
+export declare function getLunarCycle(year: number): number;
+/** Phase of the moon on `date`, as a fraction of the lunar month.
+ *  0 = new moon, 0.5 = full, wraps at 1. */
+export declare function getLunarPhase(date: JulianDate): number;
+/** Bucket the fractional phase into one of the eight cardinal names, using
+ *  a +/- half-lunar-day window around each cardinal point. */
+export declare function getLunarPhaseName(date: JulianDate): LunarPhaseName;
+/** Julian-calendar date of the next new moon on/after `date`, floor of the
+ *  Metonic estimate (matches upstream rounding). */
+export declare function getNextNewMoon(date: JulianDate): JulianDate;
+/** Julian-calendar date of the next full moon on/after `date`. */
+export declare function getNextFullMoon(date: JulianDate): JulianDate;
+//# sourceMappingURL=lunar.d.ts.map

package/dist/astronomy/lunar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lunar.d.ts","sourceRoot":"","sources":["../../src/astronomy/lunar.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,sDAAsD;AACtD,eAAO,MAAM,WAAW,cAAc,CAAC;AAEvC;4DAC4D;AAC5D,eAAO,MAAM,cAAc,cAAc,CAAC;AAW1C,iDAAiD;AACjD,MAAM,MAAM,cAAc,GACvB,KAAK,GACL,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,MAAM,GACN,gBAAgB,GAChB,cAAc,GACd,iBAAiB,CAAC;AAErB,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;4CAC4C;AAC5C,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAetD;AAED;8DAC8D;AAC9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAWlE;AAED;oDACoD;AACpD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAI3D;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAK5D"}

package/dist/astronomy/lunar.js

@@ -0,0 +1,87 @@
+// Ported from lunar-phase paths in Ponomar/Paschalion.java. The phase is
+// computed **not astronomically** but on the Metonic cycle — sufficient for
+// liturgical purposes and identical to upstream. Marked "experimental" by
+// upstream; guarantees are as-is.
+import { julianDate, julianDateFromJdn } from "../core/calendar/jdate.js";
+/** Mean synodic month, in days. Upstream constant. */
+export const LUNAR_MONTH = 29.52916667;
+/** Half a lunar "day" — the window around each cardinal phase within
+ *  which {@link getLunarPhaseName} rounds to that phase. */
+export const LUNAR_HALF_DAY = 0.016932411;
+/** Age of the moon (days since new moon) on 1 March Julian for each of the
+ *  19 years of the Metonic cycle. Index 0 → cycle 1, …, index 18 → cycle 19. */
+const FOUNDATION = [
+    14.042016807, 25.462184874, 6.084033613, 17.966386555, 28.336134454,
+    9.210084034, 20.504201681, 1.420168067, 12.294117647, 23.168067227,
+    4.546218487, 15.042016807, 26.294117647, 7.630252101, 18.546218487,
+    29.420168067, 11.756302521, 26.210084034, 3.042016807,
+];
+/** Metonic-cycle index (1..19) for a Julian-calendar year (AD 33 or later). */
+export function getLunarCycle(year) {
+    if (!Number.isInteger(year) || year < 33) {
+        throw new RangeError(`year must be an integer >= 33, got ${year}`);
+    }
+    let t = (year + 1) % 19 - 3;
+    if (t <= 0)
+        t += 19;
+    return t;
+}
+/** Phase of the moon on `date`, as a fraction of the lunar month.
+ *  0 = new moon, 0.5 = full, wraps at 1. */
+export function getLunarPhase(date) {
+    const year = date.year;
+    const cycle = getLunarCycle(year);
+    const march1 = julianDate(year, 3, 1);
+    let diff = date.jdn - march1.jdn;
+    if (diff < 0) {
+        diff = date.jdn - julianDate(year - 1, 3, 1).jdn;
+    }
+    let remainder = mod(diff, LUNAR_MONTH);
+    remainder += FOUNDATION[cycle - 1];
+    while (remainder >= LUNAR_MONTH)
+        remainder -= LUNAR_MONTH;
+    return remainder / LUNAR_MONTH;
+}
+/** Bucket the fractional phase into one of the eight cardinal names, using
+ *  a +/- half-lunar-day window around each cardinal point. */
+export function getLunarPhaseName(date) {
+    const raw = getLunarPhase(date);
+    const r = LUNAR_HALF_DAY;
+    if (raw < r || raw > 1 - r)
+        return "new";
+    if (raw < 0.25 - r)
+        return "waxing-crescent";
+    if (raw <= 0.25 + r)
+        return "first-quarter";
+    if (raw < 0.5 - r)
+        return "waxing-gibbous";
+    if (raw <= 0.5 + r)
+        return "full";
+    if (raw < 0.75 - r)
+        return "waning-gibbous";
+    if (raw <= 0.75 + r)
+        return "last-quarter";
+    return "waning-crescent";
+}
+/** Julian-calendar date of the next new moon on/after `date`, floor of the
+ *  Metonic estimate (matches upstream rounding). */
+export function getNextNewMoon(date) {
+    const age = getLunarPhase(date) * LUNAR_MONTH;
+    const diff = Math.floor(LUNAR_MONTH - age);
+    return shiftJdn(date, diff);
+}
+/** Julian-calendar date of the next full moon on/after `date`. */
+export function getNextFullMoon(date) {
+    const age = getLunarPhase(date) * LUNAR_MONTH;
+    let diff = Math.floor(LUNAR_MONTH / 2 - age);
+    if (diff < 0)
+        diff = Math.floor(LUNAR_MONTH / 2 - age + LUNAR_MONTH);
+    return shiftJdn(date, diff);
+}
+function mod(a, m) {
+    return a - m * Math.floor(a / m);
+}
+function shiftJdn(date, days) {
+    return julianDateFromJdn(date.jdn + days);
+}
+//# sourceMappingURL=lunar.js.map

package/dist/astronomy/lunar.js.map

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

package/dist/astronomy/sunrise.d.ts

@@ -0,0 +1,41 @@
+import type { CalendarDate } from "../core/calendar/pcalendar.ts";
+/** Standard altitude constants (in degrees below the horizon) accepted as
+ *  `altitude` in {@link SunriseSunsetOptions}. */
+export declare const SunAltitude: {
+    /** Sun's upper limb touches horizon with atmospheric refraction (default). */
+    readonly DEFAULT: -0.833;
+    /** Civil twilight — reading outside without artificial light is no longer possible. */
+    readonly CIVIL: -6;
+    /** Nautical twilight. */
+    readonly NAUTICAL: -12;
+    /** Amateur astronomical twilight. */
+    readonly AMATEUR: -15;
+    /** Astronomical twilight — sky completely dark. */
+    readonly ASTRONOMICAL: -18;
+};
+export interface SunriseSunsetOptions {
+    /** East longitude positive, west negative. Degrees. */
+    readonly longitude: number;
+    /** North latitude positive, south negative. Degrees. */
+    readonly latitude: number;
+    /** Local timezone offset from UTC in hours (positive east). */
+    readonly tzOffsetHours: number;
+    /** If true, add 1 hour for daylight-saving. Defaults to false. */
+    readonly isDST?: boolean;
+    /** Altitude of the sun at "sunset", in degrees. Defaults to -0.833. */
+    readonly altitude?: number;
+}
+export interface SunriseSunsetResult {
+    /** Local-time hour of sunrise (0..24). Decimal — multiply fractional part by 60 for minutes. */
+    readonly sunriseHours: number;
+    /** Local-time hour of sunset (0..24). */
+    readonly sunsetHours: number;
+    /** True when the sun never rises above the target altitude on this day. */
+    readonly sunAlwaysDown: boolean;
+    /** True when the sun never sets below the target altitude on this day. */
+    readonly sunAlwaysUp: boolean;
+}
+export declare function getSunriseSunset(date: CalendarDate, opts: SunriseSunsetOptions): SunriseSunsetResult;
+/** Format a decimal-hours value as `HH:MM` (24-hour clock, zero-padded). */
+export declare function formatClock(hours: number): string;
+//# sourceMappingURL=sunrise.d.ts.map

package/dist/astronomy/sunrise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sunrise.d.ts","sourceRoot":"","sources":["../../src/astronomy/sunrise.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE;kDACkD;AAClD,eAAO,MAAM,WAAW;IACvB,8EAA8E;;IAE9E,uFAAuF;;IAEvF,yBAAyB;;IAEzB,qCAAqC;;IAErC,mDAAmD;;CAE1C,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACpC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IACnC,gGAAgG;IAChG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC9B;AAoDD,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,oBAAoB,GACxB,mBAAmB,CAqCrB;AAQD,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/astronomy/sunrise.js

@@ -0,0 +1,111 @@
+// Ported from Ponomar/Sunrise.java (which is itself a port of Paul Schlyter's
+// public-domain SUNRISET.C, 1992). Computes sunrise/sunset for any latitude,
+// longitude and civil date. Standalone — no dependency on the rest of the
+// engine.
+import { _internal } from "../core/calendar/jdate.js";
+/** Standard altitude constants (in degrees below the horizon) accepted as
+ *  `altitude` in {@link SunriseSunsetOptions}. */
+export const SunAltitude = {
+    /** Sun's upper limb touches horizon with atmospheric refraction (default). */
+    DEFAULT: -0.833,
+    /** Civil twilight — reading outside without artificial light is no longer possible. */
+    CIVIL: -6,
+    /** Nautical twilight. */
+    NAUTICAL: -12,
+    /** Amateur astronomical twilight. */
+    AMATEUR: -15,
+    /** Astronomical twilight — sky completely dark. */
+    ASTRONOMICAL: -18,
+};
+const INV360 = 1 / 360;
+const RADEG = 180 / Math.PI;
+const DEGRAD = Math.PI / 180;
+const UPPER_LIMB = true;
+const sind = (n) => Math.sin(n * DEGRAD);
+const cosd = (n) => Math.cos(n * DEGRAD);
+const acosd = (n) => RADEG * Math.acos(n);
+const atan2d = (y, x) => RADEG * Math.atan2(y, x);
+function revolution(angle) {
+    return angle - 360 * Math.floor(angle * INV360);
+}
+function rev180(x) {
+    return x - 360 * Math.floor(x * INV360 + 0.5);
+}
+/** JDN of 1999-12-31 Gregorian, i.e. "Jan 0.0, 2000 Gregorian". */
+const JDN_JAN0_2000 = 2451544;
+function gmst0(d) {
+    return revolution(180 + 356.047 + 282.9404 + (0.9856002585 + 4.70935e-5) * d);
+}
+function sunpos(d) {
+    const M = revolution(356.047 + 0.9856002585 * d);
+    const w = 282.9404 + 4.70935e-5 * d;
+    const e = 0.016709 - 1.151e-9 * d;
+    const E = M + e * RADEG * sind(M) * (1 + e * cosd(M));
+    const x = cosd(E) - e;
+    const y = Math.sqrt(1 - e * e) * sind(E);
+    const r = Math.sqrt(x * x + y * y);
+    let lon = atan2d(y, x) + w;
+    if (lon >= 360)
+        lon -= 360;
+    return { r, lon };
+}
+function sunRaDec(d) {
+    const { r, lon } = sunpos(d);
+    let x = r * cosd(lon);
+    let y = r * sind(lon);
+    const obl = 23.4393 - 3.563e-7 * d;
+    const z = y * sind(obl);
+    y *= cosd(obl);
+    const ra = atan2d(y, x);
+    const dec = atan2d(z, Math.sqrt(x * x + y * y));
+    return { ra, dec, r };
+}
+export function getSunriseSunset(date, opts) {
+    const { longitude, latitude } = opts;
+    const isDST = opts.isDST ?? false;
+    let altitude = opts.altitude ?? SunAltitude.DEFAULT;
+    const tz = opts.tzOffsetHours + (isDST ? 1 : 0);
+    const jdn = _internal.gregorianYmdToJdn(date.year, date.month, date.day);
+    const d = (jdn - JDN_JAN0_2000) + 0.5 - longitude / 360;
+    const sidtime = revolution(gmst0(d) + 180 + longitude);
+    const { ra, dec, r } = sunRaDec(d);
+    const tsouth = 12 - rev180(sidtime - ra) / 15;
+    const sradius = 0.2666 / r;
+    if (UPPER_LIMB)
+        altitude -= sradius;
+    const cost = (sind(altitude) - sind(latitude) * sind(dec))
+        / (cosd(latitude) * cosd(dec));
+    let t;
+    let sunAlwaysDown = false;
+    let sunAlwaysUp = false;
+    if (cost >= 1) {
+        t = 0;
+        sunAlwaysDown = true;
+    }
+    else if (cost <= -1) {
+        t = 12;
+        sunAlwaysUp = true;
+    }
+    else {
+        t = acosd(cost) / 15;
+    }
+    let sunriseHours = tsouth - t + tz;
+    let sunsetHours = tsouth + t + tz;
+    sunriseHours = normHours(sunriseHours);
+    sunsetHours = normHours(sunsetHours);
+    return { sunriseHours, sunsetHours, sunAlwaysDown, sunAlwaysUp };
+}
+function normHours(h) {
+    if (h > 24)
+        return h - 24;
+    if (h < 0)
+        return h + 24;
+    return h;
+}
+/** Format a decimal-hours value as `HH:MM` (24-hour clock, zero-padded). */
+export function formatClock(hours) {
+    const h = Math.floor(hours);
+    const m = Math.floor((hours - h) * 60);
+    return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}`;
+}
+//# sourceMappingURL=sunrise.js.map

package/dist/astronomy/sunrise.js.map

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

package/dist/bible/format.d.ts

@@ -0,0 +1,9 @@
+import type { BibleBook, BibleRef } from "./types.ts";
+/** Look up a book by any accepted form (`Id`, `Short`, `Name`, or
+ *  `Short`-with-underscores). Returns `undefined` when unknown. */
+export declare function findBook(nameOrShort: string): BibleBook | undefined;
+/** Format a `BibleRef` back to the upstream `<Label>_<Chapter>:<Spec>` form.
+ *  Uses the original `bookLabel` from the parsed input, so
+ *  `formatBibleRef(parseBibleRef(x)) === x` for every corpus reference. */
+export declare function formatBibleRef(ref: BibleRef): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/bible/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/bible/format.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAA6B,MAAM,YAAY,CAAC;AAEjF;mEACmE;AACnE,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAInE;AAED;;2EAE2E;AAC3E,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAMpD"}

package/dist/bible/format.js

@@ -0,0 +1,38 @@
+// Small helpers around `BIBLE_BOOKS`: alias lookup and canonical
+// string formatting for a parsed `BibleRef`.
+import { BIBLE_BOOK_ALIASES, BIBLE_BOOKS } from "../data/index.js";
+/** Look up a book by any accepted form (`Id`, `Short`, `Name`, or
+ *  `Short`-with-underscores). Returns `undefined` when unknown. */
+export function findBook(nameOrShort) {
+    const id = BIBLE_BOOK_ALIASES[nameOrShort.trim()];
+    if (id === undefined)
+        return undefined;
+    return BIBLE_BOOKS[id];
+}
+/** Format a `BibleRef` back to the upstream `<Label>_<Chapter>:<Spec>` form.
+ *  Uses the original `bookLabel` from the parsed input, so
+ *  `formatBibleRef(parseBibleRef(x)) === x` for every corpus reference. */
+export function formatBibleRef(ref) {
+    if (ref.ranges.length === 0) {
+        return `${ref.bookLabel}_${ref.chapter}`;
+    }
+    const spec = ref.ranges.map((r) => formatRange(r, ref.chapter)).join(", ");
+    return `${ref.bookLabel}_${ref.chapter}:${spec}`;
+}
+function formatRange(range, primaryChapter) {
+    const startStr = formatEndpoint(range.start, primaryChapter, /*explicitChapter*/ false);
+    if (range.start.chapter === range.end.chapter
+        && range.start.verse === range.end.verse
+        && range.start.part === range.end.part) {
+        return startStr;
+    }
+    const endStr = formatEndpoint(range.end, range.start.chapter, range.end.chapter !== range.start.chapter);
+    return `${startStr}-${endStr}`;
+}
+function formatEndpoint(ep, contextChapter, forceChapter) {
+    const needChapter = forceChapter || ep.chapter !== contextChapter;
+    const prefix = needChapter ? `${ep.chapter}:` : "";
+    const part = ep.part ?? "";
+    return `${prefix}${ep.verse}${part}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/bible/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/bible/format.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,6CAA6C;AAE7C,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGnE;mEACmE;AACnE,MAAM,UAAU,QAAQ,CAAC,WAAmB;IAC3C,MAAM,EAAE,GAAG,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;2EAE2E;AAC3E,MAAM,UAAU,cAAc,CAAC,GAAa;IAC3C,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAAC,KAAiB,EAAE,cAAsB;IAC7D,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACxF,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;WACzC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,GAAG,CAAC,KAAK;WACrC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAC5B,KAAK,CAAC,GAAG,EACT,KAAK,CAAC,KAAK,CAAC,OAAO,EACnB,KAAK,CAAC,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,CACzC,CAAC;IACF,OAAO,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,cAAc,CACtB,EAAiB,EACjB,cAAsB,EACtB,YAAqB;IAErB,MAAM,WAAW,GAAG,YAAY,IAAI,EAAE,CAAC,OAAO,KAAK,cAAc,CAAC;IAClE,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IAC3B,OAAO,GAAG,MAAM,GAAG,EAAE,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;AACtC,CAAC"}

package/dist/bible/index.d.ts

@@ -0,0 +1,5 @@
+export type { BibleBook, BibleRef, VerseEndpoint, VerseRange } from "./types.ts";
+export { BibleRefError, parseBibleRef } from "./parse.ts";
+export { findBook, formatBibleRef } from "./format.ts";
+export { BIBLE_BOOKS, BIBLE_BOOK_ALIASES } from "../data/index.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/bible/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bible/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/bible/index.js

@@ -0,0 +1,8 @@
+// Barrel for the Bible reference parser + book registry.
+//
+// The generated book registry lives in `src/data/bibleBooks.ts`; this
+// folder wraps it with the runtime parser and a small formatter.
+export { BibleRefError, parseBibleRef } from "./parse.js";
+export { findBook, formatBibleRef } from "./format.js";
+export { BIBLE_BOOKS, BIBLE_BOOK_ALIASES } from "../data/index.js";
+//# sourceMappingURL=index.js.map

package/dist/bible/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bible/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,sEAAsE;AACtE,iEAAiE;AAGjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/bible/parse.d.ts

@@ -0,0 +1,7 @@
+import type { BibleRef } from "./types.ts";
+export declare class BibleRefError extends Error {
+    readonly input: string;
+    constructor(input: string, message: string);
+}
+export declare function parseBibleRef(input: string): BibleRef;
+//# sourceMappingURL=parse.d.ts.map

package/dist/bible/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/bible/parse.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAA6B,MAAM,YAAY,CAAC;AAEtE,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAmCrD"}